Modifying USMT and KACE to capture Firefox settings and other specific programs

It's that time in the hardware refresh cycle again where you have to replace laptops on mass, well at least it is for me.

Our main challenge was migrating users Firefox bookmarks and also the desire to capture Outlook signatures and auto-complete information without capturing all Office applications information (we wanted to start as fresh as possible).

I've never really dug in depth into the USMT and K2000 before now and I've found it in needed of a little massaging.

USMT Problem

The USMT definition XML file for applications (MigApp.xml) included with USMT 5.0 does provide support for many non Microsoft productions including Firefox, Chrome and Adobe Acrobat amongst other. The only problem is Microsoft hasn't had the inclination to keep it up-to-date.

Thanks to some clues from fellow ITNinja Jegolf, I found that the MigApp.xml is hard coded to look for Mozilla Firefox 3 (hello cira 2008).

USMT FIX: (assuming WAIK 8)

Edit the MigApp.xml files in both the C:\Program Files (x86)\Windows Kits\8.1\Assessment and Deployment Kit\User State Migration Tool\amd64   and   C:\Program Files (x86)\Windows Kits\8.1\Assessment and Deployment Kit\User State Migration Tool\x86 folders.

The line to modify:

DEFAULT:  <condition>MigXmlHelper.DoesObjectExist("Registry","%HklmWowSoftware%\Mozilla\Mozilla Firefox 3.*\bin [PathToExe]")</condition>

MODIFIED: <condition>MigXmlHelper.DoesObjectExist("Registry","%HklmWowSoftware%\Mozilla\Mozilla Firefox *.*\bin [PathToExe]")</condition>

After making these modifications, re-upload the USMT tool into the K2000.

Now if you choose the User Data tick box under Documents To Be Scanned in the K2000 USMT Scan Template, any version of Firefox will correctly be migrated.

Firefox specific migration (and other) without migrating ALL User Data

In the K2000 USMT Scan Template, if you tick User Data then it migrates anything in the MigApp.xml template which is anything from Firefox to all Office components to Acrobat etc etc.

This is not particularly helpful if you want to be more granular about what you take to ensure you don't pass on redundant or out of date settings.

To customize the USMT Scan Template created in the K2000 is not as easy as it could be.

  • Create a KACE USMT Scan Template and customize it with any visible settings but DO NOT tick User Data
  • Export this USMT Scan Template from the Package Management area of the K2000
  • Browse to the <K2000>\restore Samba share and find the exported package
  • Extract the package with 7-Zip
  • Open the extracted file with notepad and copy the USMT XML component out to a new file.

        This begins with <Configuration> and ends with </Configuration>

  • Save this file with XML file extension
  • In the K2000, open your USMT Scan Template and under the Content Configuration tick Specify config file.
  • Browse and select the XML file you created and then Save the USMT Scan Template.

When you reopen this USMT Scan Template, the K2000 shows it in the Template GUI format but as this GUI is not aware of the Applications section of the config file it won't be displayed. It does exist and modifying and saving the USMT Scan Template will not overwrite it (an export of the USMT Scan Template proves this).

So, what have we learned:

a) Microsoft didn't bother fixing this Firefox version number hard coding in the MmigApp.xml file. This is possibly a problem for Chrome and other applications mentioned in it.

b) KACE USMT Scan Template GUI is not aware of Applications section of config file.

c) KACE USMT Scan Templates are ALL or nothing for applications. Granularity of applications already built into USMT (anything listed in MigApp.xml) would be better.

d) the 'Specify config file' option in the KACE USMT Scan Templates is ambiguous as to the required format of the config file. I only got this working when I exported a template from the KACE (thank KACE support as I wasn't aware you could extract the packages) and copied the XML.
The ability to directly save an example config or the current config out for modification would make it simple to add customisation.


  • Hi TheatreByte. I appreciate you taking the time to provide these detailed instructions. I am trying to use this guide to grab the Outlook sig files. I am running into a problem locating the MigApp.xml file in the two locations that you mentioned.

    I am using Win7, and cannot find the "Windows Kits" Directory you refer to. I've got Windows AIK installed for Windows 7.

    You refer to WAIK 8, but I was unable to find a versioning number with what I have installed. Is there something else that needs to be installed? Like you, I have also never tried toying with the USMT.
    Help would be appreciated. - Kevino2010 9 years ago
  • Did you install the Windows Assessment and Deployment Kit (ADK) for Windows® 8?
    http://www.microsoft.com/en-us/download/details.aspx?id=30652 - theatrebyte 8 years ago
  • Awesome post. We were wondering about it. As per last lines in the post, I did a search for Chrome - found what I think was a line that might be limiting what USMT picks up (Chrome 1.*) - changed it and will give it a try.

    However not clear on the Outlook settings. How do I get those to come across? - hutcha4113 8 years ago
    • Add the Outlook section to the Applications area of the exported USMT Scan Template. - theatrebyte 8 years ago
This post is locked

Don't be a Stranger!

Sign up today to participate, stay informed, earn points and establish a reputation for yourself!

Sign up! or login


This website uses cookies. By continuing to use this site and/or clicking the "Accept" button you are providing consent Quest Software and its affiliates do NOT sell the Personal Data you provide to us either when you register on our websites or when you do business with us. For more information about our Privacy Policy and our data protection efforts, please visit GDPR-HQ