diff --git a/windows/deploy/resolve-windows-10-upgrade-errors.md b/windows/deploy/resolve-windows-10-upgrade-errors.md index 5aef1c48e6..634137d387 100644 --- a/windows/deploy/resolve-windows-10-upgrade-errors.md +++ b/windows/deploy/resolve-windows-10-upgrade-errors.md @@ -45,15 +45,16 @@ WIM = Windows image (Microsoft) Setup will return two codes: 1. A result code, corresponding to a specific Win32 error. -2. An extend code, corresponding to the phase and the operation when a failure occurred. +2. An extend code, representing the phase when a failure occurred. + - The extend code contains information about both the *phase* in which an error occurred, and the *operation* that was being performed when the error occurred. -For example, a result code of **0xC1900101** with an extend code of **0x4000D** will be returned as: **0xC1900101 - 0x4000D** +>For example, a result code of **0xC1900101** with an extend code of **0x4000D** will be returned as: **0xC1900101 - 0x4000D**. In this case, the extend code 0x4000D can be evaluated as representing a problem during phase 4 (0x4) with data migration (000D). A list of extend codes and the associated phase and operation is provided below. -Note: If only a single code is returned, this can be because a tool is being used that does not capture the extend code, for example the [Windows 10 Upgrade Assistant](https://support.microsoft.com/en-us/kb/3159635). +Note: If only a result code is returned, this can be because a tool is being used that was not able to capture the extend code. For example, if you are using the [Windows 10 Upgrade Assistant](https://support.microsoft.com/en-us/kb/3159635) then only a result code might be returned. ### Extend codes -The following tables display the phase and operation assoicated with an extend code: +The following tables provide the corresponding phase and operation for values of an extend code:
Extend code: phase | @@ -114,30 +115,41 @@ The following tables display the phase and operation assoicated with an extend c
Log file | Description | Location | When to use - |
setupact.log | Contains information about setup actions during the installation. | Down-Level phase: $Windows.~BT\Sources\Panther | All down-level failures and starting point for rollback investigations. - |
setuperr.log | Contains information about setup errors during the installation. | Same location as setupact.log - | |
Setupmem.dmp | If OS bugchecks during upgrade, setup will attempt to extract a mini-dump. | $Windows.~BT\Sources\Rollback - | |
miglog.xml | Contains information about the user directory structure. This information includes security identifiers (SIDs). | Windows\Panther - | |
Appraiser XML logs | Contains application compatibility information. | $Windows.~BT\Sources\Panther - | |
BlueBox.log | Contains information communication between setup.exe and Windows Update. | Windows\Logs\Mosetup | -Log file | Phase: Location | Description | When to use
+
+setupact.log | Down-Level: | $Windows.~BT\Sources\Panther Contains information about setup actions during the downlevel phase. | All down-level failures and starting point for rollback investigations. | This is the most important log for diagnosing setup issues. + OOBE: | $Windows.~BT\Sources\Panther Contains information about actions during the OOBE phase. | Investigating rollbacks that failed during OOBE phase and operations – 0x4001C, 0x4001D, 0x4001E, 0x4001F.
+ | Rollback: | $Windows.~BT\Sources\Panther Contains information about actions during rollback. | Investigating generic rollbacks - 0xC1900101.
+ | Pre-initialization (prior to downlevel): | $Windows.~BT\Sources\Panther Contains information about initializing setup. | If setup fails to launch.
+ | Post-upgrade (after OOBE): | $Windows.~BT\Sources\Panther Contains information about setup actions during the installation. | Investigate post-upgrade related issues.
+
+ | setuperr.log | Same as setupact.log | Contains information about setup errors during the installation. | Review all errors encountered during the installation phase.
+
+ | miglog.xml | Post-upgrade (after OOBE): | Windows\Panther Contains information about what was migrated during the installation. | Identify post upgrade data migration issues.
+
+ | BlueBox.log | Down-Level: | Windows\Logs\Mosetup Contains information communication between setup.exe and Windows Update. | Use during WSUS and WU down-level failures or for 0xC1900107.
+
+ | Supplemental rollback logs: | +Setupmem.dmp +setupapi.dev.log +Event logs (*.evtx) + + + $Windows.~BT\Sources\Rollback | Additional logs collected during rollback. |
+Setupmem.dmp: If OS bugchecks during upgrade, setup will attempt to extract a mini-dump. | +Setupapi: Device install issues – 0x30018 +Event logs: Generic rollbacks (0xC1900101) or unexpected reboots. + + + + + |