This document will provide a sample configuration for implementing background images for each Cisco IP Phone model on Cisco Unified Communications Manager.
The following scenario uses Cisco Unified Communications Manager version 8.5, however the configurations shown here apply to any currently supported version of Cisco Unified Communications Manager. We will walk through adding several background images to 7975 and 7942 phones, but the steps for any other phone model can be adapted based on the image sizes and directory location paths noted in the table in the Additional Information section.
This document assumes no previous image uploads have occurred.
PLEASE NOTE: CUCM runs in a Linux environment, everything is CASE SENSITIVE! As such the "Directory" option MUST be consistent when uploading files for each phone type. E.G. The path /Desktops/320x216x16 and /desktops/320x216x16 are considered separate paths. Additionally make sure your xml file is "List.xml" NOT "list.xml" and any capitals in your image names are properly refleced in the List.xml file or unexpected behavior will occur!
In the steps below we will be setting background images for all 7975s and 7942s in our cluster.
The images you wish to provide as phone backgrounds can be anything which you have permission to use, for example, your companies logo. Do not use images which you do not have explicit permission to re-distribute or use.
For the images, the following restrictions apply:
List.xml files also have a specific format, but it is relatively simple. Be aware that any mistakes will result in parsing errors on the phones and your background images will not show up! DO NOT create these files in a word processor, create them in a plain-text editor to prevent invalid characters from being added to the xml file.
<ImageItem Image="TFTP:Desktops/PhoneImagePath/ThumbnailFileName.png" URL="TFTP:Desktops/PhoneImagePath/FullSizeImage.png"/>
For each List.xml your file opens with a <CiscoIPPhoneImageList> tag and ends with a </CiscoIPPhoneImageList> tag.
For every image you want to offer you will need an <ImageItem ... /> line. The "Image" property defines the path to the thumbnail image and the "URL" property is used to define the path the the fullsize image.
Below are the the List.xml files for the 7975 and the 7942, respectively which we will be using:
Note that the Desktop directory is dependent on the type of phone you are creating a background for, see Additional Information section at the bottom of this document.
List.xml for 7975s:
<ImageItem Image="TFTP:Desktops/320x216x16/7975BackgroundTN.png" URL="TFTP:Desktops/320x216x16/7975Background.png"/>
<ImageItem Image="TFTP:Desktops/320x216x16/7975BackgroundTN2.png" URL="TFTP:Desktops/320x216x16/7975Background2.png"/>
List.xml for 7942s:
<ImageItem Image="TFTP:Desktops/320x196x4/7942BackgroundTN.png" URL="TFTP:Desktops/320x196x4/7942Background.png"/>
<ImageItem Image="TFTP:Desktops/320x196x4/7942BackgroundTN2.png" URL="TFTP:Desktops/320x196x4/7942Background2.png"/>
<ImageItem Image="TFTP:Desktops/320x196x4/7942BackgroundTN3.png" URL="TFTP:Desktops/320x196x4/7942Background3.png"/>
So as you can see, we have two image options for the 7975 and three image options for the 7942s. Now we need to upload everything to the proper locations on the TFTP server(s).
**the 7985 phone does not display thumbnails so set the "Image" value to the path of the fullsize image as well as the "URL" value.
The List.xml file is located in the Desktops/640x480x24 folder. Assuming you do not have a NACL, Firewall etc. blocking access, you can certainly use a TFTP client from your desktop to retrieve the files. You may also use the webinterface of the TFTP service using the (http://<pub>:6970/Desktops/640x480x24/List.xml) url. You can ssh to the CUCM server and use the file dump command to dump the file to the screen. Use the scroll back buffer to retreive the content of List.xml. You can also use file get to download the file to a SFTP server running in your network or on your desktop.
Here we are going to upload the files. As stated at the beginning of the document, everything is case sensitive, watch your use of CAPS!
1. Log into the Cisco Unified Operating System Administration page and select Software Upgrades -> TFTP File Management
2. Under TFTP File Management, click "Upload File":
3. Upload each file to the correct directory path. I have only shown the uploads for the 7975 since the uploads for the 7942 is the same process, just a slightly adjusted "Directory" field.
List.xml (for 7975) file upload:
Thumbnail image upload (7975):
Full size image upload (7975):
After each sucessful upload you should be presented with the following screen:
4. We repeat the above steps for the other 7975 Background image and thumbnail file.
5. We then follow the same steps for the 7942 List.xml and background images/thumbnails, making sure the Directory path for those uploads is always /Desktops/320x196x4 You will notice that this is different than the directory for the 7975 phones.
6. Repeat steps 1 through 5 for EACH node in your cluster running the TFTP service.
Now that all our files should be in place, it is always best practice to look for them in the expected directory path to make sure all files have been uploaded correctly. I have shown my TFTP File Management Search results after uploading ALL of the files mentioned above.
7975 directory search:
7942 directory search:
Now that we have verified all the files uploaded successfully we can move to the next step.
Now we need to restart the TFTP service on each node in the cluster which runs it.
1. Log into the Cisco Unified Serviceability page and select Tools -> Control Center - Feature Services.
2. Select the node running TFTP from the drop down and click Go.
3. Check the Cisco TFTP bubble and press Restart.
Feature Services Screen:
4. Repeat Steps 2 and 3 for each node in your cluster running the TFTP service.
Now that everything should be in place on the CUCM side of things, you should go to a couple 7975s and a couple 7942s and try to look up background images, please see the following document on setting a background image on your phone. The phone should reach out to the server to try and get the list of available background images.
Below is a table which describes the image dimensions (in pixels) for both thumbnails and full size background images, along with their exact upload paths for each phone type.
Width x Height (pixels) for full image
Width x Height (pixels) for thumbnail imageExact Directory
|7906 / 7911||95x34||23x8||/Desktops/95x34x1|
|7941 / 7961||320x196||80x49||/Desktops/320x196x4|
|7942 / 7962||320x196||80x49||/Desktops/320x196x4|
|7945 / 7965||320x212||80x53||/Desktops/320x212x16|
|7970 / 7971||320x212||80x53||/Desktops/320x212x12|
|8961 / 9951 / 9971||640x480||123x111||/Desktops/640x480x24|
**This phone will not provide a thumbnail preview so use the full size image for thumbnail as well.