diff --git a/windows/deployment/upgrade/resolve-windows-10-upgrade-errors.md b/windows/deployment/upgrade/resolve-windows-10-upgrade-errors.md
index 71202e04e6..7c3caa7d84 100644
--- a/windows/deployment/upgrade/resolve-windows-10-upgrade-errors.md
+++ b/windows/deployment/upgrade/resolve-windows-10-upgrade-errors.md
@@ -7,6 +7,7 @@ ms.mktglfcycl: deploy
ms.sitesec: library
ms.pagetype: deploy
author: greg-lindsay
+ms.date: 10/10/2017
ms.localizationpriority: high
---
@@ -21,8 +22,8 @@ ms.localizationpriority: high
This topic contains a brief introduction to Windows 10 installation processes, and provides resolution procedures that IT administrators can use to resolve issues with Windows 10 upgrade. The following sections and procedures are provided in this guide:
-- [The Windows 10 upgrade process](#the-windows-10-upgrade-process): An explanation of phases used during the upgrade process.
-- [Quick fixes](#quick-fixes): Steps you can take to eliminate many Windows upgrade errors.
+- [The Windows 10 upgrade process](#the-windows-10-upgrade-process): An explanation of phases used during the upgrade process.
+- [Quick fixes](#quick-fixes): Steps you can take to eliminate many Windows upgrade errors.
- [Upgrade error codes](#upgrade-error-codes): The components of an error code are explained.
- [Result codes](#result-codes): Information about result codes.
- [Extend codes](#extend-codes): Information about extend codes.
@@ -53,15 +54,15 @@ The Windows Setup application is used to upgrade a computer to Windows 10, or to

-DU = Driver/device updates.
-OOBE = Out of box experience.
+DU = Driver/device updates.
+OOBE = Out of box experience.
WIM = Windows image (Microsoft)
## Quick fixes
The following steps can resolve many Windows upgrade problems.
-
Extend code: phase | -|||||||||||||
Hex | Phase
-0 | SP_EXECUTION_UNKNOWN
- | 1 | SP_EXECUTION_DOWNLEVEL
- | 2 | SP_EXECUTION_SAFE_OS
- | 3 | SP_EXECUTION_FIRST_BOOT
- | 4 | SP_EXECUTION_OOBE_BOOT
- | 5 | SP_EXECUTION_UNINSTALL
- | |
Extend code: operation | -|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
-
|
-
-
|
-
Extend code: phase | +|
Hex | Phase + |
0 | SP_EXECUTION_UNKNOWN + |
1 | SP_EXECUTION_DOWNLEVEL + |
2 | SP_EXECUTION_SAFE_OS + |
3 | SP_EXECUTION_FIRST_BOOT + |
4 | SP_EXECUTION_OOBE_BOOT + |
5 | SP_EXECUTION_UNINSTALL + |
Extend code: operation | +|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
+
|
+
+
|
+
The following table describes some log files and how to use them for troubleshooting purposes:
+The following table describes some log files and how to use them for troubleshooting purposes:
-
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\UnattendGC - 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\Rollback Contains information about actions during rollback. | Investigating generic rollbacks - 0xC1900101.
- | Pre-initialization (prior to downlevel): | Windows Contains information about initializing setup. | If setup fails to launch.
- | Post-upgrade (after OOBE): | Windows\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. - - |
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\UnattendGC |
+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\Rollback | Contains information about actions during rollback. | Investigating generic rollbacks - 0xC1900101. | +|
Pre-initialization (prior to downlevel): Windows | Contains information about initializing setup. | If setup fails to launch. | +|
Post-upgrade (after OOBE): Windows\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. |
+
To analyze Windows Setup log files:
+
To analyze Windows Setup log files:
-
setuperr.log content:
+
setuperr.log content:
27:08, Error SP Error READ, 0x00000570 while gathering/applying object: File, C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18 [CN]. Will return 0[gle=0x00000570] @@ -306,7 +303,7 @@ The first line indicates there was an error **0x00000570** with the file **C:\Pr Therefore, Windows Setup failed because it was not able to migrate the corrupt file **C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18\[CN]**. This file is a local system certificate and can be safely deleted. Searching the setupact.log file for additional details, the phrase "Shell application requested abort" is found in a location with the same timestamp as the lines in setuperr.log. This confirms our suspicion that this file is the cause of the upgrade failure: --setupact.log content: +
setupact.log content:27:00, Info Gather started at 10/5/2016 23:27:00 @@ -329,15 +326,16 @@ Therefore, Windows Setup failed because it was not able to migrate the corrupt f 27:08, Info Gather ended at 10/5/2016 23:27:08 with result 44 27:08, Info Leaving MigGather method 27:08, Error SP SPDoFrameworkGather: Gather operation failed. Error: 0x0000002C -+
This analysis indicates that the Windows upgrade error can be resolved by deleting the C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18\[CN] file. Note: In this example, the full, unshortened file name is C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18\be8228fb2d3cb6c6b0ccd9ad51b320b4_a43d512c-69f2-42de-aef9-7a88fabdaa3f.
+
+
This analysis indicates that the Windows upgrade error can be resolved by deleting the C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18\[CN] file. Note: In this example, the full, unshortened file name is C:\ProgramData\Microsoft\Crypto\RSA\S-1-5-18\be8228fb2d3cb6c6b0ccd9ad51b320b4_a43d512c-69f2-42de-aef9-7a88fabdaa3f.
## Resolution procedures
### 0xC1900101
-A frequently observed result code is 0xC1900101. This result code can be thrown at any stage of the upgrade process, with the exception of the downlevel phase. 0xC1900101 is a generic rollback code, and usually indicates that an incompatible driver is present. The incompatible driver can cause blue screens, system hangs, and unexpected reboots. Analysis of supplemental log files is often helpful, such as:
+A frequently observed result code is 0xC1900101. This result code can be thrown at any stage of the upgrade process, with the exception of the downlevel phase. 0xC1900101 is a generic rollback code, and usually indicates that an incompatible driver is present. The incompatible driver can cause blue screens, system hangs, and unexpected reboots. Analysis of supplemental log files is often helpful, such as:
- The minidump file: $Windows.~bt\Sources\Rollback\setupmem.dmp,
- Event logs: $Windows.~bt\Sources\Rollback\*.evtx
@@ -345,346 +343,346 @@ A frequently observed result code is 0xC1900101. This result code can be thrown
The device install log is particularly helpful if rollback occurs during the sysprep operation (extend code 0x30018). To resolve a rollback due to driver conflicts, try running setup using a minimal set of drivers and startup programs by performing a [clean boot](https://support.microsoft.com/en-us/kb/929135) before initiating the upgrade process.
-
See the following general troubleshooting procedures associated with a result code of 0xC1900101:
+
See the following general troubleshooting procedures associated with a result code of 0xC1900101:
-
+ | ||||||||||||||
-
|
+
Cause + |
Windows Setup encountered an error during the SAFE_OS with the INSTALL_RECOVERY_ENVIRONMENT operation
+ This is generally caused by out-of-date drivers. + |
Mitigation - |
Uninstall antivirus applications.
- Remove all unused SATA devices. - Remove all unused devices and drivers. - Update drivers and BIOS. - |
Mitigation + |
Uninstall antivirus applications.
+ Remove all unused SATA devices. + Remove all unused devices and drivers. + Update drivers and BIOS. + |
Code - |
0xC1900101 - 0x2000c - |
Code + |
0xC1900101 - 0x2000c + |
Cause - |
Windows Setup encountered an unspecified error during Wim apply in the WinPE phase.
- This is generally caused by out-of-date drivers. - |
Cause + |
Windows Setup encountered an unspecified error during Wim apply in the WinPE phase.
+ This is generally caused by out-of-date drivers. + |
Mitigation - |
Disconnect all peripheral devices that are connected to the system, except for the mouse, keyboard and display.
- Contact your hardware vendor to obtain updated device drivers. - Ensure that "Download and install updates (recommended)" is accepted at the start of the upgrade process. - |
Mitigation + |
Disconnect all peripheral devices that are connected to the system, except for the mouse, keyboard and display.
+ Contact your hardware vendor to obtain updated device drivers. + Ensure that "Download and install updates (recommended)" is accepted at the start of the upgrade process. + |
Code - | ||
0xC1900101 - 0x20017
+
|
Cause - |
A driver has caused an illegal operation.
- Windows was not able to migrate the driver, resulting in a rollback of the operating system. - This is a safeOS boot failure, typically caused by drivers or non-Microsoft disk encryption software. - |
Cause + |
A driver has caused an illegal operation.
+ Windows was not able to migrate the driver, resulting in a rollback of the operating system. + This is a safeOS boot failure, typically caused by drivers or non-Microsoft disk encryption software. + |
Mitigation - | ||
-Ensure that all that drivers are updated. +
|
-
Code - |
0xC1900101 - 0x30018 - |
Code + |
0xC1900101 - 0x30018 + |
Cause - |
A device driver has stopped responding to setup.exe during the upgrade process. - |
Cause + |
A device driver has stopped responding to setup.exe during the upgrade process. + |
Mitigation - | ||
+
|
-
Code - |
0xC1900101 - 0x3000D - |
Code + |
0xC1900101 - 0x3000D + |
Cause - | ||
Installation failed during the FIRST_BOOT phase while attempting the MIGRATE_DATA operation.
- This can occur due to a problem with a display driver. +
|
+
Mitigation - | ||
+
|
-
Code - |
0xC1900101 - 0x4000D - |
Code + |
0xC1900101 - 0x4000D + |
Cause - | ||
A rollback occurred due to a driver configuration issue.
- Installation failed during the second boot phase while attempting the MIGRATE_DATA operation.
+
|
+
Mitigation - | ||
- Check supplemental rollback logs for a setupmem.dmp file, or event logs for any unexpected reboots or errors. - Review the rollback log and determine the stop code.
- Info SP Crash 0x0000007E detected
-
|
-
Code - |
0xC1900101 - 0x40017 - |
Code + |
0xC1900101 - 0x40017 + |
Cause - |
Windows 10 upgrade failed after the second reboot.
- This is usually caused by a faulty driver. For example: antivirus filter drivers or encryption drivers. - |
Cause + |
Windows 10 upgrade failed after the second reboot.
+ This is usually caused by a faulty driver. For example: antivirus filter drivers or encryption drivers. + |
Mitigation - | ||
Clean boot into Windows, and then attempt the upgrade to Windows 10. +
|
-
Result codes starting with the digits 0x800 are also important to understand. These error codes indicate general operating system errors, and are not unique to the Windows upgrade process. Examples include timeouts, devices not functioning, and a process stopping unexpectedly.
+
Result codes starting with the digits 0x800 are also important to understand. These error codes indicate general operating system errors, and are not unique to the Windows upgrade process. Examples include timeouts, devices not functioning, and a process stopping unexpectedly.
-
See the following general troubleshooting procedures associated with a result code of 0x800xxxxx:
+
See the following general troubleshooting procedures associated with a result code of 0x800xxxxx:
-
+ | ||||||||||||||
-
|
-+ |
-
|
+||||||||||||
+ | ||||||||||||||
-
|
-+ |
-
|
+||||||||||||
+ | ||||||||||||||
-
|
-+ |
-
|
+||||||||||||
+ | ||||||||||||||
-
|
-+ |
-
|
+||||||||||||
+ | ||||||||||||||
-
|
-+ |
-
|
+||||||||||||
+ | ||||||||||||||
-
|
-+ |
-
|
+
See [Windows 10 specifications](https://www.microsoft.com/en-us/windows/windows-10-specifications) for information.
Ensure that "Download and install updates (recommended)" is accepted at the start of the upgrade process.
Ensure that "Download and install updates (recommended)" is accepted at the start of the upgrade process.
You can also download the [Windows Assessment and Deployment Kit (ADK) for Windows 10](http://go.microsoft.com/fwlink/p/?LinkId=526740) and install Application Compatibility Tools.
+
You can also download the [Windows Assessment and Deployment Kit (ADK) for Windows 10](http://go.microsoft.com/fwlink/p/?LinkId=526740) and install Application Compatibility Tools.
The error 80072efe means that the connection with the server was terminated abnormally.
+
The error 80072efe means that the connection with the server was terminated abnormally.
-
To resolve this issue, try the OS Deployment test on a client in same VLAN as the Configuration Manager server. Check the network configuration for random client-server connection issues happening on the remote VLAN.
+
To resolve this issue, try the OS Deployment test on a client in same VLAN as the Configuration Manager server. Check the network configuration for random client-server connection issues happening on the remote VLAN.
For detailed information on how to run these steps check out How to delete upgrades in WSUS.
+Error Codes | Cause | Mitigation | ||
0x80070003- 0x20007 - | This is a failure during SafeOS phase driver installation. + | |||
Error Codes | Cause | Mitigation | ||
0x80070003- 0x20007 + | This is a failure during SafeOS phase driver installation. - | [Verify device drivers](https://msdn.microsoft.com/windows/hardware/drivers/install/troubleshooting-device-and-driver-installations) on the computer, and [analyze log files](#analyze-log-files) to determine the problem driver. - | ||
0x8007025D - 0x2000C - | This error occurs if the ISO file's metadata is corrupt. | "Re-download the ISO/Media and re-attempt the upgrade. + | [Verify device drivers](https://msdn.microsoft.com/windows/hardware/drivers/install/troubleshooting-device-and-driver-installations) on the computer, and [analyze log files](#analyze-log-files) to determine the problem driver. + | |
0x8007025D - 0x2000C + | This error occurs if the ISO file's metadata is corrupt. | "Re-download the ISO/Media and re-attempt the upgrade. Alternatively, re-create installation media the [Media Creation Tool](https://www.microsoft.com/en-us/software-download/windows10). - | ||
0x80070490 - 0x20007 | An incompatible device driver is present. + | |||
0x80070490 - 0x20007 | An incompatible device driver is present. - | [Verify device drivers](https://msdn.microsoft.com/windows/hardware/drivers/install/troubleshooting-device-and-driver-installations) on the computer, and [analyze log files](#analyze-log-files) to determine the problem driver. + | [Verify device drivers](https://msdn.microsoft.com/windows/hardware/drivers/install/troubleshooting-device-and-driver-installations) on the computer, and [analyze log files](#analyze-log-files) to determine the problem driver. - | |
0xC1900101 - 0x2000c - | An unspecified error occurred in the SafeOS phase during WIM apply. This can be caused by an outdated driver or disk corruption. - | Run checkdisk to repair the file system. For more information, see the [quick fixes](#quick-fixes) section in this guide.
- Update drivers on the computer, and select "Download and install updates (recommended)" during the upgrade process. Disconnect devices other than the mouse, keyboard and display. | ||
0xC1900200 - 0x20008 + | ||||
0xC1900101 - 0x2000c + | An unspecified error occurred in the SafeOS phase during WIM apply. This can be caused by an outdated driver or disk corruption. + | Run checkdisk to repair the file system. For more information, see the [quick fixes](#quick-fixes) section in this guide.
+ Update drivers on the computer, and select "Download and install updates (recommended)" during the upgrade process. Disconnect devices other than the mouse, keyboard and display. | ||
0xC1900200 - 0x20008 - | The computer doesn’t meet the minimum requirements to download or upgrade to Windows 10. + | The computer doesn’t meet the minimum requirements to download or upgrade to Windows 10. - | See [Windows 10 Specifications](https://www.microsoft.com/en-us/windows/windows-10-specifications) and verify the computer meets minimum requirements. + | See [Windows 10 Specifications](https://www.microsoft.com/en-us/windows/windows-10-specifications) and verify the computer meets minimum requirements.
- Review logs for [compatibility information](https://blogs.technet.microsoft.com/askcore/2016/01/21/using-the-windows-10-compatibility-reports-to-understand-upgrade-issues/). |
0x80070004 - 0x3000D - | This is a problem with data migration during the first boot phase. There are multiple possible causes.
+ Review logs for [compatibility information](https://blogs.technet.microsoft.com/askcore/2016/01/21/using-the-windows-10-compatibility-reports-to-understand-upgrade-issues/). | |||
0x80070004 - 0x3000D + | This is a problem with data migration during the first boot phase. There are multiple possible causes. - | [Analyze log files](#analyze-log-files) to determine the issue. | ||
0xC1900101 - 0x4001E - | Installation failed in the SECOND_BOOT phase with an error during PRE_OOBE operation. - | This is a generic error that occurs during the OOBE phase of setup. See the [0xC1900101](#0xc1900101) section of this guide and review general troubleshooting procedures described in that section. | ||
0x80070005 - 0x4000D - | The installation failed in the SECOND_BOOT phase with an error in during MIGRATE_DATA operation. This error indicates that access was denied while attempting to migrate data. - | [Analyze log files](#analyze-log-files) to determine the data point that is reporting access denied. | ||
0x80070004 - 0x50012 - | Windows Setup failed to open a file. - | [Analyze log files](#analyze-log-files) to determine the data point that is reporting access problems. | ||
0xC190020e
- 0x80070070 - 0x50011 - 0x80070070 - 0x50012 - 0x80070070 - 0x60000 - | These errors indicate the computer does not have enough free space available to install the upgrade. - | To upgrade a computer to Windows 10, it requires 16 GB of free hard drive space for a 32-bit OS, and 20 GB for a 64-bit OS. If there is not enough space, attempt to [free up drive space](https://support.microsoft.com/en-us/help/17421/windows-free-up-drive-space) before proceeding with the upgrade. + | [Analyze log files](#analyze-log-files) to determine the issue. | |
0xC1900101 - 0x4001E + | Installation failed in the SECOND_BOOT phase with an error during PRE_OOBE operation. + | This is a generic error that occurs during the OOBE phase of setup. See the [0xC1900101](#0xc1900101) section of this guide and review general troubleshooting procedures described in that section. | ||
0x80070005 - 0x4000D + | The installation failed in the SECOND_BOOT phase with an error in during MIGRATE_DATA operation. This error indicates that access was denied while attempting to migrate data. + | [Analyze log files](#analyze-log-files) to determine the data point that is reporting access denied. | ||
0x80070004 - 0x50012 + | Windows Setup failed to open a file. + | [Analyze log files](#analyze-log-files) to determine the data point that is reporting access problems. | ||
0xC190020e
+ 0x80070070 - 0x50011 + 0x80070070 - 0x50012 + 0x80070070 - 0x60000 + | These errors indicate the computer does not have enough free space available to install the upgrade. + | To upgrade a computer to Windows 10, it requires 16 GB of free hard drive space for a 32-bit OS, and 20 GB for a 64-bit OS. If there is not enough space, attempt to [free up drive space](https://support.microsoft.com/en-us/help/17421/windows-free-up-drive-space) before proceeding with the upgrade.
- Note: If your device allows it, you can use an external USB drive for the upgrade process. Windows setup will back up the previous version of Windows to a USB external drive. The external drive must be at least 8GB (16GB is recommended). The external drive should be formatted using NTFS. Drives that are formatted in FAT32 may run into errors due to FAT32 file size limitations. USB drives are preferred over SD cards because drivers for SD cards are not migrated if the device does not support Connected Standby. - |