Troubleshooting Guide

Debugging JavaScript

If you experience problems while using the Jabber SDK your first step is to open up your browser's JavaScript console and other debugging tools.

Internet Explorer

Select Tools > Developer Tools (or press F12). Click the Script tab to open the Console view in the right-hand pane. The Consle view displays any error messages from the Jabber SDK or other errors that may be causing problems.

 

Firefox

For Firefox, the Firebug add-on is an excellent tool to debug JavaScript. Go to http://getfirebug.com/ for more details.

 

Chrome

Chrome includes a good set of tools. Click the Spanner Icon and select Tools > JavaScript Console.

 

Safari

By default, the developer tools in Safari are hidden. To activate the tools, go to Preferences > Advanced and check the option "Show Develop menu in menu bar". This activates the Develop menu which contains several tools. To display the console, select Show Error Console.

 

Common Errors

TFTP fetch error

The most common reason for this error is that you haven't set up a device in Cisco Unified Communications Manager. For instructions on setting up a device, see JabberSDK_CUCM_Guide.txt is in the docs folder. Another possible cause for this error is a firewall that could be blocking TFTP access from your browser. For more information, check with your system administrator.

Plug-in not installed

Make sure that you have installed the browser plug-in as described in http://developer.cisco.com/web/jabbersdk/start


Log Files

The plug-in the SDK uses to enable telephony writes a log file to your local file system. You can find the file, softphone.log in the following locations:

  • Windows XP C:\Documents and Settings\{username}\Local Settings\Application Data\softphone.log
  • Windows 7/Vista C:\Users\{username}\Application Data\Local\softphone.log
  • Mac OS X /Users/{username}/Library/Application Support/softphone.log

While it is not really intended as a diagnostic tool for SDK users, softphone.log contains a wealth of detailed information and can be useful when you contact Cisco support.

 

Visit the Jabber Developer Forums to ask questions and interact with other developers.