A Simple CISCO/Linksys SPA Configuration Extract and Conversion Utility (Version 0.3)

The web-tility:

• reads the configuration from a CISCO/Linksys SPA (was Sipura) Analog Telephone Adaptor (ATA) and converts it into an XML format.
• has been developed and tested using an SPA-3102 with Software Version: 5.1.10(GW), if you are using a different device and its fails to work then send an email with your config file and I will see if I can fix the problem.
• is useful to provide a more portable definition of SPA configurations for exchange between people using the device (which is notoriously difficult to configure),
• allows organisations with many SPAs to convert a working configuration and provision it across a number of devices and
• optionally generates downloadable XML provisioning file (in two alternate formats - version 0.3)

The tool provides the option of extracting "Router" and/or "Voice" configurations (as per capture here):

It requires that the SPA device is connected to the Internet (it has to be to receive incoming SIP calls..) with the HTTP Server available on the WAN port.

You can check this by looking at your SPA "Router/Wan Setup/Remote Management/Enable WAN Web Server" setting. This needs to be set to "yes".

As this tool looks to your SPA like a user with a browser, it will need to login to the SPA as "admin" in order to extract the configuration.

Go here for example configuration informaton and tips.

Note that the SPA only provide HTTP access, however it does use "Digest Authentication", so while user id & password will be encrypted all configuration data will be sent in the clear (from your SP to this Web Server). For those concerned with security, it is likely that HTTP (via Port 80 by default) is filtered by your router, so if you need to get the XML file out of your device, then you will need to lower the gates temporarily to allow extract of the configuration.

This utility does not log or store any of your identity information, the user id is never used or stored once the SPA configuration has been extracted. For those who are really concerned about security and have the inclination to tinker, the source PHP code for the web-tility is available here.

Note: there appear to be two different XML formats:

• Value Format - <tag-name ... value="xxx" />
• Enclosed Format - <tag-name ...>value</tag>

You can select which format you want in the following config choices

NOTE: Cisco have released a new version of SPA3102 firmware (version: 5.2.13)

This includes support for generating XML config by using the following URL: http://ip_addr/admin/config.xml

I recommend that SPA users use this, I have not checked to see if other SPA also now support this, so am keeping this page up, just in case

All materials (C) Copyright Graphica Software/Dokmai Pty Ltd, unless otherwise noted.

Send any questions or comments regarding this site to info at graphica.com.au
Last Updated: Monday 9th April, 2012.