Aaron Stebner's WebLog

Thoughts about setup and deployment issues, WiX, XNA, the .NET Framework and Visual Studio

XNA Game Studio Cleanup Tool User's Guide

XNA Game Studio Cleanup Tool User's Guide

Rate This
  • Comments 31

XNA Game Studio Cleanup Tool User's Guide

Introduction

The XNA Game Studio cleanup tool is designed to automatically perform a set of steps to remove selected versions of XNA Game Studio from a computer.  It will remove files, directories, registry keys and values and Windows Installer product registration information for XNA Game Studio.  The tool is intended primarily to return your system to a known (relatively clean) state in case you are encountering XNA Game Studio installation, uninstallation or repair errors so that you can try to install again.

There is a very important caveat that you should review before using this tool to remove any version of XNA Game Studio from your system:

  • This tool is designed as a last resort for cases where install, uninstall, repair or patch installation did not succeed for unusual reasons.  It is not a substitute for the standard uninstall procedure.  You should try to uninstall XNA Game Studio from Add/Remove Programs prior to using this tool.

Download location

The XNA Game Studio cleanup tool is available for download at the following locations:

The .zip file that contains the tool also contains a file named history.txt that lists when the most recent version of the tool was published and what changes have been made to the tool over time.

Supported products

The XNA Game Studio cleanup tool supports removing the following products:

  • XNA Game Studio 2.0
  • XNA Game Studio 3.0
  • XNA Game Studio 3.1
  • XNA Game Studio 4.0
  • XNA Game Studio 4.0 Refresh
  • Windows Phone Developer Tools 7.0
  • Windows Phone SDK 7.1

Silent installation mode

The XNA Game Studio cleanup tool supports running in silent mode.  In this mode, the tool will run without showing any UI, and the user must pass in a version of XNA Game Studio to remove as a command line parameter.  To run the cleanup tool in silent mode, you need to download the cleanup tool, extract the file cleanup_tool.exe from the zip file, and then run it using syntax like the following:

cleanup_tool.exe /q:a /c:"cleanup.exe /p <name of product to remove>"

The value that you pass with the /p switch to replace <name of product to remove> in this example must exactly match one of the products listed in the Supported products section above.  For example, if you would like to run the cleanup tool in silent mode and remove XNA Game Studio 3.0, you would use a command line like the following:

cleanup_tool.exe /q:a /c:"cleanup.exe /p XNA Game Studio 3.0"

Unattended installation mode

The XNA Game Studio cleanup tool supports running in unattended mode.  In this mode, the tool will run and only show a progress dialog during removal, but will require no user interaction.  Unattended mode requires the user to pass in a version of XNA Game Studio to remove as a command line parameter.  To run the cleanup tool in unattended mode, you need to download the cleanup tool, extract the file cleanup_tool.exe from the zip file, and then run it using syntax like the following:

cleanup_tool.exe /q:a /c:"cleanup.exe /p <name of product to remove> /u"

For example, if you would like to run the cleanup tool in unattended mode and remove XNA Game Studio 2.0, you would use a command line like the following:

cleanup_tool.exe /q:a /c:"cleanup.exe /p XNA Game Studio 2.0 /u" 

Exit codes

The cleanup tool can return the following exit codes:

  • 0 - cleanup completed successfully for the specified product
  • 3010 - cleanup completed successfully for the specified product and a reboot is required to complete the cleanup process
  • 1 - cleanup tool requires administrative privileges on the machine
  • 2 - the required file cleanup.ini was not found in the same path as cleanup.exe
  • 4 - a product name was passed in that does not exist in cleanup.ini
  • 100 - cleanup was able to start but failed during the cleanup process
  • 1602 - cleanup was cancelled

Log files

The cleanup tool creates the following log files:

  • %temp%\cleanup_main.log - a log of all activity during each run of the cleanup tool; this is a superset of the logs listed below as well as some additional information
  • %temp%\cleanup_actions.log - a log of actions taken during removal of each product; it will list files that it finds and removes, product codes it tries to remove, registry entries it tries to remove, etc.
  • %temp%\cleanup_errors.log - a log of errors and warnings encountered druing each run of the cleanup tool

 

Attachment: xnags_cleanup_tool.zip
  • It seems that i have already tried everything including this tool , but sill the problem presists...

    It always asks me to uninstall Windows Phone Developer Tools.

    Tried already to:

    -Uninstall:

     - All Silverlight CTP , SDK, Toolkits even the runtime.

     - All XNA Framework related all versions

     - I have now only the VS2010 Ultimate

    Remove:

     - Use your tool and remove all and reboot

     - Manually delete all keys encountered with "Windows Phone".

    Sill i have no luck the problem is the same still!

  • Hi Nunorelvao - If you've already tried the uninstall tool and you're still being blocked from installing the CTP Refresh due to incompatible products, then can you please use the tool in the blog post at http://blogs.msdn.com/astebner/archive/2005/07/01/434814.aspx to gather a list of installed products on your system, then post the log file it creates to a file server (such as http://skydrive.live.com/) and reply here with a link I can use to download the log and take a look?

    Also, a note for the future for anyone else reading this blog post - you should never need to manually remove registry keys to solve this type of problem.  Doing so can be dangerous because it will leave your computer in an unknown state.  You should allow the normal uninstall process to remove registry keys for you.

  • Thanks for the quick reply Aaron, here his the link to the msiinv log:

    http://eiy8pw.blu.livefilestore.com/y1pd-sqFzDnuNdurA1z0OfeiE5jKR4_8vyCFb3QANWKPV8gvWQr4PNkzucc18nUn-9H1KZ_xE4Wsqu8RXPteyqC-Y0nHAcEH4uG/msiinv_output.txt

  • Hi Nunorelvao - Thanks for posting the file.  It looks like you're also discussing this issue on the XNA Creators Club forums at http://forums.xna.com/forums/p/52634/319291.aspx, so I'm going to go ahead and reply there rather than duplicating replies in 2 places.

    If anyone else runs into similar issues in the future, please post a question on the XNA Creators Club forums as well.

  • Do you have an updated version that works with the newer CTP? I can't uninstall that to put the new beta on, which was released today.

  • Hi Morten - I just uploaded an updated version of the cleanup tool.  However, the previous version was already configured to allow you to remove the previous CTPs so you shouldn't need a new version for that scenario.  What exact error did you see while trying to uninstall the previous CTP on your system?

  • Having the same issue. There is no error message on uninstall. After running the July 12th version of the tool, "Windows Phone Developer Tools" is still listed in 'Add Remove Programs'.

    'Windows Install Clean Up' tool does not show it in lists.

    Removing all registry entries with 'Windows Phone' and restarting does not help either.

    Can you please tell, how 'vm_web.exe' installer detects previous version?

  • Hey, the only program that I can't uninstall is Microsoft Windows Phone Developer Tools CTP.

    My problem is exactly the same as the guy's problem in this page: social.msdn.microsoft.com/.../45d21430-f1e6-4da8-80dd-71e9c4452bf6

    But, if I use the cleanup tool, it doesn't work... What do I have to do?

  • Hi Evgheni and Lucas - The WPDT beta setup uses information in the file blocker.sdb that is packaged inside of vm_web.exe to decide whether or not old versions of the product are still installed.  I uploaded a copy of this file for the WPDT beta setup to cid-27e6a35d1a492af7.office.live.com/.../WPDT%5E_Beta%5E_Blocker.sdb.  What I do in this scenario is look in %temp%\dd_install_vm_xcor_100.txt to see the exact name of the component that it thinks is an older version, then I go to blocker.sdb and look for the information about what registry key is being used to check the version number.

    Can you please give that a try and see if it helps you narrow this down further?  If it doesn't help, please post your file %temp%\dd_install_vm_xcor_100.txt to a file server such as http://skydrive.live.com, then reply back here with a link that I can use to download the log file and take a further look.

  • Thanks! I got it!

    [Microsoft Windows Phone Developer Tools CTP Refresh]

    VersionCheck=FileRegVerCheck

    DetectKey=HKLM,SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{8D6C687E-56A5-3563-86F7-ECF3B4FD3C0F}

    DetectKeyVal=DisplayVersion

    DetectKeyValData=

    HelpLink=Block_on_Non_Dev10_RC_component_vm_exp.htm

    I have deleted the reg "DisplayVersion". Now it installs... Let me see if it is going to work...

    Thanks!!!!

  • I'm having the same problem, I uninstalled XNA 4 CTP then tried to uninstall Win Phone Dev Tools CTP - ENU, but that just says "install these apps" and it lists a few... I tick them all and it downloads and tries to install, but all of them fail.

    I tried using the xnags_cleanup_tool but that says its succesfull but it still detects Win Phone Dev Tools CTP when trying to install XNA 4.

  • Hi ED - Do the steps in my previous comment (using dd_install_vm_xcor_100.txt and blocker.sdb) help resolve your issue?  If not, please post your file %temp%\dd_install_vm_xcor_100.txt to a file server such as http://skydrive.live.com, then reply back here with a link that I can use to download the log file and take a further look.

  • Everything Workds, but the Windows Phone 7 Emulator doesnt...

    It gives me an error:

    "Failed to connect to "Windows Phone 7 Emulator".  ( The rest is in portuguese(my windows's language) saying that the configuration data for this product are corrupted. )

    I guess I have to reinstall the Windows Phone 7 Emulator, but from where I can get it?

  • Hi Lucas - It might help to do the following for this error:

    1.  Close Visual Studio

    2.  Delete the following folders - %LocalAppData%\Microsoft\Phone Tools and %ProgramData%\Microsoft\XDE

    3.  Re-open Visual Studio again and try to deploy to the emulator

    If this doesn't help, then I'd suggest posting a question on the Windows Phone forums at social.msdn.microsoft.com/.../windowsphone to see if someone there is able to provide some additional suggestions for you to try.

  • Hi, I can't even find an uninstaller for XNA 4 CTP in Add/Remove programs, been looking for 30mins on a way to remove this, and I can't try the original CTP installer as Microsoft has replaced the page with the Beta version. Compared my add/remove list to a recent install on my colleagues PC and his is correct. What's the recommended manual solution? cheers

Page 1 of 3 (31 items) 123
Leave a Comment
  • Please add 1 and 7 and type the answer here:
  • Post