Extracting / Pushing a Device's XML Configuration


Fri, 07/22/2016 - 08:42
Feb 17th, 2009
User Badges:
  • Cisco Employee,

Ever find yourself wishing that you could save the configuration of a SPA phone, ATA, or IP PBX, and then restore it later?

[Edit October 2nd 2009: not supported by PAP2T, SPA2102, or SPA3102 devices]

Of course you can use the SPA9000 Setup Wizard to save and restore SPA9xx IP phone backups in a SPA9000 Voice System deployment.

But what if you just want to tweak a device's configuration and then restore it, and you don't want to use the Wizard?

You will need:

  - a TFTP server [search for a free one on the Internet]

  - a simple text editor that does not insert characters on its own [vim, for example]

Sometimes I find it very useful to extract the XML configuration from a device with the following command:


For example: [where the SPA device's IP address is]

I then copy and paste the output into a plain text file.

I like to name the file for the device I'm working with, for example: SPA962_feb172009.xml.

I edit the file with vi or vim, but not NotePad because it can insert unwanted characters.

Assume I called the file SPA962_feb172009.xml

I can now edit SPA962_feb172009.xml and then push the modified configuration back to the device with the following command:


Example: Assume IP address of the:

  SPA device is

  TFTP server is

The URL would be:

The device will request the file name that I specified, retrieve the file from the TFTP server, reboot, load, and run the new configuration.



Reilly Chase Thu, 08/20/2015 - 14:55
User Badges:


This article says it does not work for SPA3102, but SPA3102 can do all the same things with slightly different syntax for the XML config download (config.xml instead of spacfg.xml)


Download SPA3102 Current XML Config

http://<IP of SPA3102>/admin/config.xml


Provision SPA3102 Remotely [Resync]

http://<IP of SPA3102>/admin/resync?tftp://<IP of TFTP or HTML SERVER>/< YOUR NEW CONFIG.xml>


Upgrade SPA3102 Firmware remotely

http://<IP of SPA3102>/admin/upgrade?tftp://<IP of TFTP or HTML SERVER>/<firmware.bin>


Patrick Born Tue, 09/08/2009 - 13:21
User Badges:
  • Cisco Employee,

Hi esmeraldaduran,

That is not a download URL. It is an example of what you type in the browser. You need to replace <IP_of_device> with the IP address of the SPA942 or SPA3102 for example.

For example, your device's IP address is so you would change

http://<IP_of_device>/admin/spacfg.xml to be

Good luck.




esmeraldaduran Tue, 09/08/2009 - 18:28
User Badges:

Hi Patrick

Yes sure I changed the ip address and show up the error 404 no found

I have a spa8800 I don’t know if the process is the same to SPA942


atcomputing Fri, 10/02/2009 - 05:44
User Badges:

When using Linux, another way to get the config is

$ wget $(SPA942HOST)/admin/spacfg.xml --output-document=SPA942.xml

Patrick Born Fri, 10/02/2009 - 07:57
User Badges:
  • Cisco Employee,

Indeed. For those without Linux/UNIX, you can use the GNU wget SourceForge project which provides Windows support.

Thanks for contributing atcomputing.




lukasz_naumowicz Fri, 11/27/2009 - 06:26
User Badges:

Hi Patrick,

Is there possibility to push configuration to PAP2T using the same command syntax like in the phones?

I'm asking beacuse I've seen the added comment on the top of the documment, and we need such thing for PAP2T ATAs.



scd2zaken Tue, 01/12/2010 - 13:38
User Badges:


We have developm. a small tool called cid4u.exe .. to collect calls from the SPA942.
I have used the information who is available in the spacfg.xml during call.
Do you think I can use this file (status of the phone) also to push a phone number TO it .. I want to give the tool .. also ' push to call'  functionality.

I can not find any extra information to give a ' push' call to the phone .. I'am believing that this option is not available .. is it ?


Eric Oosterbaan


trotty1970 Tue, 10/26/2010 - 13:27
User Badges:


I have setup the tftp server to pick up an XML file I have saved but am not having much joy.

I issue the browser command:

The SPA9000 then generates the following screen message:

SPA will resync the profile when it is not in use  and reboot
you can click HERE to return to the  configuration page

However, it never attempts to talk to the tftp server. I have turned off the firewall and tried the usual tricks but no luck. Can I force it to resync or have I made a basic error?

uhudson_z Thu, 11/11/2010 - 16:08
User Badges:

That was a very well written article, and the best documentation to date on the subject, however

It doesnt work

"SPA will rysync the profile when it is not in use and reboot

you can click here to return to the configuration page"

How to force it to be "not in use" and make it reboot and get the appropriate file? The SPA seems to ignore dchp option 66 tftp, and this way is about my last option

sourceminer Mon, 02/21/2011 - 08:01
User Badges:

I agree uleave, Love the attempts to make great documentaion, however I wonder if support is even testing against the documets. I have had this forum post explain exactly what is being done and still have yet to get an answer that is not a cop out or generic response.


Also regarding this thread: https://supportforums.cisco.com/docs/DOC-13059

Although I understand that a phone will reboot after these items are changed, doesnt explain why they continue to reboot.

Patrick Born Tue, 12/01/2009 - 15:28
User Badges:
  • Cisco Employee,

Hi Lukasz,

1. Use the PAP2T SPC utility to generate a configuration template.

2. Modify the template to make a configuration file for the PAP2T.

3. Cause the PAP2T to resync so that it retrieves its configuration from a provisioning server.

The instructions in this SPA500 family phone document are mostly valid for the PAP2T:




atcomputing Thu, 02/05/2015 - 10:23
User Badges:

Sorry, I don't know the SPA232.

I do know the SPA932 which has no IP-address, it's config is part of the SPA962-config

mbutler099 Thu, 07/21/2016 - 11:40
User Badges:

What if you do not know the initial admin password?

It will not allow me to resync without it.

Dan Lukes Thu, 07/21/2016 - 14:13
User Badges:
  • Red, 2250 points or more
  • Cisco Designated VIP,

    2017 Small Business

What you mean "initial admin password" ? Default password is well known for retail unit, so just reset unit to factory default.

If your unit is RC, it has been manufactured for particular OEM. Ask seller for password.

mbutler099 Fri, 07/22/2016 - 04:03
User Badges:

The phone was purchased third hand through an ebay auction. An Admin Password was set by a previous owner. There is no way to obtain that password, so there is no way to reset the phone to factory, as it keeps asking for an admin password.

If anyone knows of a way to push a new password to the phone, or knows of an "override" password, that would be greatly appreciated.


Dan Lukes Fri, 07/22/2016 - 04:25
User Badges:
  • Red, 2250 points or more
  • Cisco Designated VIP,

    2017 Small Business

Yes, it's possible to lock unit against unauthorized reset to factory default. Admin password is required in such case for reset.

It's intentional (and valuable) security feature of the phone. As the matter of this feature is - no access to configuration from unauthorized person - it's not possible to have public backdoor allowing a rogue user to jump the barrier.

Only Cisco can help you (call Support Center), but I'm pretty sure they will not help you to unlock phone intentional locked by it's administrator. Moreover, I'm almost sure you got RC unit. Those unit are not for resale and even reset to factory default will not help you.

So sorry I have no good news for you, but that it is. You has been cheated by seller. 

mbutler099 Fri, 07/22/2016 - 08:42
User Badges:


The display has all four(4) lines reading:    104-ZpizzaCary

So I guess these phones are useless to me, as I can not reprogram them for my use..