Installing rss2cisco on Your Web Server

Step by step directions on how to install the rss2cisco perl script on your windows or linux based web server.


Joshua Cantara
Last Revised: April 21st, 2005

Summary

      This document will cover in a step by step fashion how to download, install and configure a perl script to display RSS feeds on a Cisco VOIP Telephone's LCD display.

Index

  1. Configuring your feeds
  2. Windows with IIS Specific Instructions
  3. Linux/BSD/OSX/etc with Apache Specific Instructions
  4. Setting up the Phone Service in Call Manager
  5. Conclusion

Configuring your feeds

The first step is to actually download the rss2cisco script, but if you can't figure that out without a tutorial then this is probably the wrong task for you. Once you have the script downloaded, open it up in the text editor of your choice. Do note that because it uses unix line breaks, Notepad on windows is NOT a good choice. Wordpad, however, will display it fine. As will any application on Linux or BSD/OSX.

Look for the line "ATTENTION: EDIT THE FOLLOWING VARIABLES" and go to the $pathto line below it. Do not disturb or change any other characters on this line and inside the single quotes put the location your script will end up at. Such as: 'http://dontpokebadgers.com/phone_services' Do NOT put a slash at the end of this line as the script will automatically add one later.

Below that line is where we enter the RSS feeds we want. RSS feed configurations are 2 lines per RSS feed. One line is for the title/description, the other is for the URL that the feed is located at. Copy one of the example feeds and replace everything inside the single quotes on the @descriptions line with the name of the feed. Visit a website you enjoy and find their RSS icon or link. Take the URL to the feed and place it inside the single quotes of the @feeds line, replacing the existing feed URL. Do this as many times as you want, however Cisco IP phones have a limit of 64 menu items, so you can't exceed that.

That completes all the changes you need to make inside the script. Please do not change anything else unless you know what you are doing. Even changing by accident a single character will cause the script to fail and you'll have to start over again. Be mindful of your editing!

Save your changes to the file, rename it to rss2cisco.pl and move along to the next step.

Windows with IIS Specific Instructions

These directions are for users who are running Windows server 2000 or 2003 with Microsoft's IIS web server. Please skip them if this is not your configuration. Open Internet Explorer and go to URL that your script now lives at. ie: http://myserver.net/phone/rss2cisco.pl If you see something that looks like this:

You have completed the configuration sucessfully! If you see an error or the text of the script itself, then something went wrong and you should start over.

Linux/BSD/OSX/etc with Apache Specific Instructions

These directions are for users who are running Linux, FreeBSD, OpenBSD, or OSX with the Apache web server. Please skip them if this is not your configuration. Open Mozilla Firefox and go to URL that your script now lives at. ie: http://myserver.net/phone/rss2cisco.pl If you see something that looks like this:

You have completed the configuration sucessfully! If you see an error or the text of the script itself, then something went wrong and you should start over.

Setting up the Phone Service in Call Manager

Here's where we log into Call Manager's web admin interface and set up the phone service, then apply it to phones. If you don't know how to get into your Call Manager server's web interface what the hell are you doing here? Now the phone service is set up and availble in your Call Manager server. To apply the service to individual phones do the following.

Conclusion

      Now that all your steps are done you should be able to go to your phone, load the service, and display RSS feeds. If not then something has gone wrong and you should review the steps and start again from scratch, checking all your work as you go.