Skip to content

Commit e9d5ca0

Browse files
committed
TOC & Acrolinx updates
1 parent 315597c commit e9d5ca0

2 files changed

Lines changed: 11 additions & 9 deletions

File tree

support/windows-client/setup-upgrade-and-drivers/use-windows-setup-compatibility-scan-logs-to-identify-blocking-issues.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ During a feature update or in-place upgrade, Windows Setup runs a compatibility
2424

2525
## Symptoms
2626

27-
You run a Windows feature update or an in-place upgrade on a Windows computer. The Windows Setup process fails, and produces the `0xC1900208` error code. This code indicates a compatibility issue. Typically, this means that the computer has an application or driver that's not compatible with the new version or feature update. This might be true even if the incompatible application or driver has already been uninstalled.
27+
You run a Windows feature update or an in-place upgrade on a Windows computer. The Windows Setup process fails, and produces the `0xC1900208` error code. This code indicates a compatibility issue. The computer has an application or driver that's not compatible with the new version or feature update. You might see this issue even if the incompatible application or driver has already been uninstalled.
2828

2929
> [!NOTE]
3030
> If Windows Setup produces the `0xC1900210` code, then there are no compatibility issues.
@@ -35,7 +35,7 @@ You run a Windows feature update or an in-place upgrade on a Windows computer. T
3535
> If you want to test compatibility before you deploy a feature update or in-place upgrade at scale (by using Microsoft Intune or Microsoft Endpoint Manager), review [How to test compatibility at scale](#how-to-test-compatibility-at-scale). That section describes special considerations and techniques to supplement the following procedure.
3636
3737
1. Use the compatibility scan logs (CompatData\*.xml or \*_APPRAISER_HumanReadable.xml) to identify the blocking issue. For more information, see [How to use the compatibility scan logs to identify the blocking issue](#how-to-use-the-compatibility-scan-logs-to-identify-the-blocking-issue).
38-
1. Fix the problematic application or driver. For example, uninstall it or upgrade it to a compatible version. If the human-readable log points to a specific file, and the related application or driver has already been installed, remove the indicated file.
38+
1. Fix the problematic application or driver. For example, uninstall it or upgrade it to a compatible version. If the human-readable log points to a specific file, and the related application or driver has already been uninstalled, remove the indicated file.
3939
1. If you intend to use the same media for the next setup attempt, clear the setup-related caches:
4040

4141
- Empty the C:\Windows\SoftwareDistribution\Download folder.
@@ -50,7 +50,7 @@ You run a Windows feature update or an in-place upgrade on a Windows computer. T
5050

5151
For more information, see [Windows Setup Command-Line Options: /Compat](/windows-hardware/manufacture/desktop/windows-setup-command-line-options?view=windows-11#compat).
5252

53-
1. Re-check the logs to make sure that the issue doesn't recur, and that Setup generated the `0xC1900210` code. If it generated the `0xC1900208` code, review the logs for further compatibility issues.
53+
1. Recheck the logs to make sure that the issue doesn't recur, and that Setup generated the `0xC1900210` code. If it generated the `0xC1900208` code, review the logs for further compatibility issues.
5454
1. When the compatibility checks pass, retry the upgrade.
5555

5656
### How to use the compatibility scan logs to identify the blocking issue
@@ -60,16 +60,16 @@ Over the course of the setup process, Windows Setup stores logs in different loc
6060
> [!TIP]
6161
> These folders are hidden. To make sure that you can search the folders, in File Explorer, select **View** and make sure that **Hidden items** is selected.
6262
63-
- Logs that're stored during the Downlevel, OOBE, or Rollback stages of the Setup process: C:\\$WINDOWS.~BT\\Sources\\Panther\\CompatData\<date-time>.xml.
63+
- Logs that Setup stores during the Downlevel, OOBE, or Rollback stages of the Setup process: C:\\$WINDOWS.~BT\\Sources\\Panther\\CompatData\<date-time>.xml.
6464

6565
> [!NOTE]
6666
> In this file path, \<date-time> represents the data and time when the file was created. The latest timestamp is most relevant to the troubleshooting process.
6767
6868
:::image type="content" source="./media/use-windows-setup-compatibility-scan-logs-to-identify-blocking-issues/list-of-compatdata-log-files.png" alt-text="Screenshot that shows a directory listing the compatibility log files.":::
6969

70-
- Logs that're stored after the OOBE stage of the Setup process: C:\Windows\Panther\.
70+
- Logs that Setup stores after the OOBE stage of the Setup process: C:\Windows\Panther\.
7171

72-
- Human readable log that's stored by the compatibility appraiser: Search the operating system drive for \*_APPRAISER_HumanReadable.xml.
72+
- Human readable log that the compatibility appraiser stores: Search the operating system drive for \*_APPRAISER_HumanReadable.xml.
7373

7474
For more information about Setup log files, see [Windows upgrade log files](/windows/deployment/upgrade/log-files).
7575

@@ -96,7 +96,7 @@ Open the most recent CompatData\<date-time>.xml.xml and search for the following
9696

9797
#### Using the \*_APPRAISER_HumanReadable.xml file
9898

99-
The human-readable log file uses a flattened, easier-to-scan XML than the CompatData logs. You can use this log to find exact file paths to files that block Setup, including .exe or .dll files that're left behind after you uninstalled an application. To find this information, follow these steps:
99+
The human-readable log file uses a flattened, easier-to-scan XML than the CompatData logs. You can use this log to find exact file paths to files that block Setup, including .exe or .dll files that are left behind after you uninstalled an application. To find this information, follow these steps:
100100

101101
1. Open the most recent \*_APPRAISER_HumanReadable.xml file, and then search for the **DT_ANY_FMC_BlockingApplication=True** string.
102102

@@ -114,13 +114,13 @@ To help resolve compatibility issues, use the [SetupDiag](/windows/deployment/up
114114
SetupDiag.exe /LogsPath "C:\Temp\WindowsSetupLogs" /Output "C:\Temp\SetupDiag-Results.txt"
115115
```
116116

117-
You can aggregate SetupDiag outputs into into your reporting pipeline.
117+
You can aggregate SetupDiag outputs into your reporting pipeline.
118118

119119
## More information
120120

121121
Microsoft Compatibility Appraiser creates registry entries in the `HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags` subkey. This process runs as the \Microsoft\Windows\Application Experience\Microsoft Compatibility Appraiser scheduled task.
122122

123-
Windows inbox and appraiser processes and Dynamic update processes write and refresh compatibility intelligence when they run scans. Windows Setup, Windows Update, and enterprise tools then use this information to to decide if a device is ready for a target release without running a full upgrade.
123+
Windows inbox and appraiser processes and Dynamic update processes write and refresh compatibility intelligence when they run scans. Windows Setup, Windows Update, and enterprise tools then use this information to decide if a device is ready for a target release without running a full upgrade.
124124

125125
## References
126126

support/windows-client/toc.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -879,6 +879,8 @@ items:
879879
href: ./setup-upgrade-and-drivers/winre-cannot-built-deploy-image-captured-non-uefi-computer.md
880880
- name: You can't access an EFI system partition
881881
href: ./setup-upgrade-and-drivers/cant-access-efi-system-partition.md
882+
- name: How to use the Windows Setup compatibility scan logs to identify blocking issues
883+
href: ./setup-upgrade-and-drivers/use-windows-setup-compatibility-scan-logs-to-identify-blocking-issues.md
882884
- name: Power management
883885
items:
884886
- name: Desktop wakes up unexpectedly from sleep or hibernation

0 commit comments

Comments
 (0)