Use SetupDiag to diagnose Windows 10 upgrade issues

Martin Brinkmann
Apr 5, 2018
Updated • Apr 6, 2018
Windows, Windows 10
|
12

SetupDiag is a free diagnostic tool by Microsoft that is designed to find and parse Windows 10 setup log files to determine why an upgrade or update failed to install on a computer system.

The program can be run on the computer that failed to upgrade or on another computer if relevant log files are available (for example, by copying them to the PC).

SetupDiag works only on devices running Windows 10. The second requirement is that it depends on the Microsoft .NET Framework 4.6 which needs to be installed on the device it is run on.

With the upcoming Windows 10 version 1803 just around the corner, it may be the right tool to have in your arsenal if you run into upgrading issues.

Using SetupDiag

You can run SetupDiag directly after download. If you run it without parameters, it attempts to locate log files that Windows 10 creates during the upgrade process in the default folders on the device.

The program creates a results.log file in its directory when it completes the scan which includes upgrade issues that it detected in the log files during parsing.

SetupDiag creates a zip archive of all log files that it processed on top of that which it saves as Logs.zip in the same directory as well.

The command line window lists those as well, but the window is closed automatically when the program finishes the scan.

Check out our list of Windows 10 upgrade log files to find out more about those. Basically, what SetupDiag does is parse the following directories for log files:

  • \$Windows.~bt\sources\panther
  • \$Windows.~bt\Sources\Rollback
  • \Windows\Panther
  • \Windows\Panther\NewOS

You may run the application in offline mode to parse folders copied from another device. The tool parses one folder only if you copy individual folders, but if you copy the parent folder, it will include all logs found in all directories of the directory structure.

SetupDiag can also be used to debug minidump files that Windows 10 may create during the upgrade process. Windows 10 creates the file setupmem.dmp either in %SystemDrive%$Windows.~bt\Sources\Rollback or in %WinDir%\Panther\NewOS\Rollback depending on when the upgrade process is stopped.

Here are some examples:

  • SetupDiag.exe -- the core command. It will run in online mode which means that it tries to find upgrade logs on the target machine in the directories mentioned above.
  • SetupDiag.exe /Output:C:\SetupDiag\Results.log /Mode:Offline /LogsPath:D:\Temp\Logs\LogSet1 - the command runs SetupDiag in offline mode. It will scan the directory LogSet1 for matching log files and issues.
  • SetupDiag.exe /Output:C:\SetupDiag\Dumpdebug.log /Mode:Offline /LogsPath:D:\Dump -- the command analyzes the setupmem.dmp file found in d:\dump.

How it works

SetupDiag uses a set of rules files to find matches in upgrade logs. Rules have a name and associated unique identifier.

The reliance on rules means that SetupDiag can only identify issues that are defined in its set of rules. Microsoft lists a total of 26 unique identifiers on the Microsoft Docs website which SetupDiag identifies in its current version.

If the program fails to find the root cause for the upgrade issue, check out our how to analyze Windows 10 upgrade errors guide which offers information on diagnosing issues manually.

Closing Words

SetupDiag may speed up the diagnosing of upgrade related issues on Windows 10 machines significantly. It reduces the time it takes to parse the log files but may still require additional research to repair the detected issue.

Some issues, like not enough disk space, are easy enough to fix but others may require extensive research and repair operations.

Now You: Did you run into Windows 10 upgrade errors in the past?

Summary
Use SetupDiag to diagnose Windows 10 upgrade issues
Article Name
Use SetupDiag to diagnose Windows 10 upgrade issues
Description
SetupDiag is a free diagnostic tool by Microsoft that is designed to find and parse Windows 10 setup log files to determine why an upgrade or update failed to install on a computer system.
Author
Publisher
Ghacks Technology News
Logo
Advertisement

Tutorials & Tips


Previous Post: «
Next Post: «

Comments

  1. Dan Donx said on January 15, 2023 at 10:29 am
    Reply

    What mental age of reader are you targeting with the first sentence? 10?

    Why not write an article on how to *avoid* upgrading from W10 to W11. Analogous to those like me who avoided upgrading from 7 to 10 for as long as possible.

    If your paymaster Microsoft permits it, of course.

  2. Dexter said on January 15, 2023 at 11:14 am
    Reply

    5. Rufus
    6. Ventoy

    PS. I hate reading these “SEO optimized” articles.

    1. cdr said on January 15, 2023 at 3:32 pm
      Reply

      I used Rufus to create an installer for a 6th gen intel i5 that had MBR. It upgraded using Setup. No issues except for Win 11 always prompting me to replace my local account. Still using Win 10 Pro on all my other PCs to avoid the bullying.

  3. sv said on January 15, 2023 at 6:40 pm
    Reply

    bit pointless to upgrade for the sake of upgrading as you never know when you’ll get locked out because ms might suddenly not provide updates to unsupported systems.

    ps…. time travelling?
    written. Jan 15, 2023
    Updated • Jan 13, 2023

    1. Martin Brinkmann said on January 16, 2023 at 5:49 am
      Reply

      This happens when you schedule a post in WordPress and update it before setting the publication date.

  4. Anonymous said on January 16, 2023 at 8:24 am
    Reply

    Anyone willing to downgrade to this awful OS must like inflicting themselves with harm.

  5. basingstoke said on January 16, 2023 at 11:18 am
    Reply

    I have become convinced now that anybody who has no qualms with using Windows 11/10 must fit into one of the following brackets:

    1) Too young to remember a time before W10 and W11 (doesn’t know better)

    2) Wants to play the latest games on their PC above anything else (or deeply needs some software which already dropped W7 support)

    3) Doesn’t know too much about how computers work, worried that they’d be absolutely lost and in trouble without the “”latest security””

    4) Microsoft apologist that tries to justify that the latest “features” and “changes” are actually a good thing, that improve Windows

    5) Uses their computer to do a bare minimum of like 3 different things, browse web, check emails, etc, so really doesn’t fuss

    Obviously that doesn’t cover everyone, there’s also the category that:

    6) Actually liked W7 more than 10, and held out as long as possible before switching, begrudgingly uses 10 now

    Have I missed any group off this list?

    1. Heinz Strunk said on September 19, 2023 at 3:57 pm
      Reply

      You have missed in this group just about any professional user that uses business software like CAD programs or ERP Programs which are 99% of all professional users from this list.

      Linux doesn’t help anyone who is not a linux kid and apple is just a fancy facebook machine.

  6. ilev said on August 24, 2023 at 7:34 pm
    Reply

    Microsoft has removed KB5029351 update

    1. EP said on August 24, 2023 at 9:21 pm
      Reply

      only from windows update though
      KB5029351 is still available from the ms update catalog site

  7. Anonymous said on August 24, 2023 at 11:05 pm
    Reply

    1. This update is labaled as PREVIEW if it causes issues to unintelligent people, then they shouldn’t have allowed Preview updates ot install.

    2. I have installed it in a 11 years old computer, and no problems at all.

    3. Making a big drama over a bluescreen for an updated labeled as preview is ridiculous.

    This is probably another BS internet drama where people ran programs and scripts that modified the registry until they broke Windows, just for removing stuff that they weren’t even using just for the sake of it.
    Maybe people should stop playing geeks and actually either use Windows 10 or Windows 11, but don’t try to modify things just for the sake of it.

    Sometimes removing or stopping things (like defender is a perfect example) only need intelligence, not scripts or 3rd party programs that might mess with windows.

  8. john said on August 24, 2023 at 11:17 pm
    Reply

    Windows 11 was a pointless release, it was just created because some of the Windows team wanted to boost sales with some sort of new and improved Windows 10. Instead, Microsoft cannot support one version well let alone two.

    1. John G. said on August 25, 2023 at 12:08 pm
      Reply

      Windows 11 is the worst ugly shame by Microsoft ever. They should release with every new W11 version a complete free version of Starallback inside just to make this sh** OS functionally again.

  9. EP said on August 25, 2023 at 3:10 pm
    Reply

    motherboard maker MSI has recently released a statement regarding the “unsupported processor” blue screen error for their boards using Intel 600/700 series chipsets & to avoid the KB5029351 Win11 update:
    https://www.msi.com/news/detail/MSI-On–UNSUPPORTED-PROCESSOR–Error-Message-of-Windows-11-Update-KB5029351-Preview-142215

  10. EP said on August 29, 2023 at 7:32 pm
    Reply

    check out the following recent articles:

    Neowin – Microsoft puts little blame on its Windows update after UNSUPPORTED PROCESSOR BSOD bug:
    https://www.neowin.net/news/microsoft-puts-little-blame-on-its-windows-update-after-unsupported-processor-bsod-bug/

    BleepingComputer – Microsoft blames ‘unsupported processor’ blue screens on OEM vendors:
    https://www.bleepingcomputer.com/news/microsoft/microsoft-blames-unsupported-processor-blue-screens-on-oem-vendors/

  11. Leonard Britvolli said on August 30, 2023 at 10:33 pm
    Reply

    While there may be changes or updates to the Windows 10 Store for Business and Education in the future, it is premature to conclude that it will be discontinued based solely on rumors.

  12. sembrador said on September 5, 2023 at 9:32 pm
    Reply

    My advice, I left win 15 years ago. Now I’m a happy linux user (linuxmint) but there is Centos, Fedora, Ubuntu depending on your needs.

  13. EP said on September 6, 2023 at 11:55 am
    Reply

    motherboard maker MSI has recently released new BIOS/firmware updates for their Intel 600 & 700 series motherboards to fix the “UNSUPPORTED_PROCESSOR” problem (Sept. 6):

    https://www.msi.com/news/detail/Updated-BIOS-fixes-Error-Message–UNSUPPORTED-PROCESSOR–caused-BSOD-on-MSI-s-Intel-700-and-600-Series-Motherboards-142277

  14. Raphael Benzo said on September 24, 2023 at 9:52 pm
    Reply

    I try to disable the Diagnostics Tracking Service (Connected Devices Platform User Services) but it wont let me disable it, any help will be greatly appreciated.
    Tank you for your help

Leave a Reply

Check the box to consent to your data being stored in line with the guidelines set out in our privacy policy

We love comments and welcome thoughtful and civilized discussion. Rudeness and personal attacks will not be tolerated. Please stay on-topic.
Please note that your comment may not appear immediately after you post it.