Skip to content

Commit 26b96bb

Browse files
authored
Update windows-update-errors-requiring-in-place-upgrade.md
1 parent db4b6e1 commit 26b96bb

File tree

1 file changed

+48
-51
lines changed

1 file changed

+48
-51
lines changed

support/azure/virtual-machines/windows/windows-update-errors-requiring-in-place-upgrade.md

Lines changed: 48 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -11,51 +11,51 @@ ms.custom:
1111
- pcy:WinComm Devices Deploy
1212
---
1313

14-
# Troubleshoot Windows update error that require in-place upgrades for Azure Virtual Machines
14+
# Troubleshoot Windows upgrade error that require in-place upgrades for Azure VMs
1515

1616
> [!IMPORTANT]
17-
> This article covers the Windows Server upgrade process for Azure servers and virtual machines (VMs) only. To do an upgrade of Windows Server not running in an Azure VM, see [In-place upgrade for VMs not running Windows Server in Azure](/windows-server/get-started/perform-in-place-upgrade).
17+
> This article covers the Windows Server upgrade process for Microsoft Azure servers and virtual machines (VMs) only. To upgrade an instance of Windows Server that isn't running on an Azure VM, see [In-place upgrade for VMs not running Windows Server in Azure](/windows-server/get-started/perform-in-place-upgrade).
1818
> [!IMPORTANT]
19-
> This article does not cover Windows Client scenarios at this time.
19+
> This article doesn't cover Windows Client scenarios.
2020
21-
For Virtual Machines running in Azure, certain Windows Update errors will require an in-place upgrade of the OS to restore the servicing stack to a healthy condition so that updates can then be installed. While other options like WinRE are available to possibly mitigate this issue, this isn't possible unless the VM is connected to a nested virtualization environment as described in [Troubleshoot a faulty Azure VM by using nested virtualization in Azure](/troubleshoot/azure/virtual-machines/windows/troubleshoot-vm-by-use-nested-virtualization). While the document instructs you to do an in-place upgrade, you will be using the media installation of the current OS and reinstalling the OS. This article provides steps to identify those specific errors requiring this action and resolve this issue.
21+
For Virtual Machines (VMs) that are running on Azure, certain Windows Update errors require an in-place upgrade of the OS to restore the servicing stack to a healthy condition on which updates can be installed. Other options, such as WinRE, are available to possibly mitigate this issue. However, such processes aren't possible unless the VM is connected to a nested virtualization environment, as described in [Troubleshoot a faulty Azure VM by using nested virtualization in Azure](/troubleshoot/azure/virtual-machines/windows/troubleshoot-vm-by-use-nested-virtualization). Although you'll be doing an in-place upgrade, you'll be using the installation media of the current OS to reinstall the system. This article provides the steps to identify the specific upgrade errors that require this action.
2222

2323
## Prerequisites
2424

25-
Ensure that you have administrative access to perform in-place upgrades.
25+
Make sure that you have administrative access to perform in-place upgrades.
2626

2727
## How to identify the errors
2828

29-
To identify the errors, check under the `C:\Windows\Logs\CBS` file path for **CBS.log**, **CbsPersist_XXXXXXXXXXXXXX.log**, or the **CbsPersist_XXXXXXXXXXXXXX.cab** file for one of the following errors:
29+
To identify upgrade errors, check the `C:\Windows\Logs\CBS` file path for **CBS.log**, **CbsPersist_XXXXXXXXXXXXXX.log**, or the **CbsPersist_XXXXXXXXXXXXXX.cab** file for one of the following error entries.
3030

31-
| Error Code | Symbolic Name | Description / Notes |
31+
| Error code | Symbolic name | Description / Notes |
3232
|------------|----------------------------------------|-------------------------------------------------------------------------------|
33-
| 8007000D | ERROR_INVALID_DATA | The data is invalid – often occurs with corrupted Windows Update metadata. |
34-
| 800705B9 | ERROR_XML_PARSE_ERROR | XML parsing error – can be related to servicing stack corruption. |
35-
| 800736B3 | ERROR_SXS_ASSEMBLY_NOT_FOUND | Assembly not found – commonly due to component store corruption. |
36-
| 80073701 | ERROR_SXS_ASSEMBLY_MISSING | A component is missing – typical for servicing/component store errors. |
37-
| 80073712 | ERROR_SXS_COMPONENT_STORE_CORRUPT | Component store has been corrupted. |
38-
| 800F080D | CBS_E_MANIFEST_INVALID_ITEM | Invalid CBS manifest – points to component corruption. |
39-
| 800F081F | CBS_E_SOURCE_MISSING | Missing source filesWindows can't find files to complete the update. |
40-
| 800F0830 | CBS_E_IMAGE_UNSERVICEABLE | Image unserviceable – often requires a repair or IPU. |
41-
| 800F0831 | CBS_E_STORE_CORRUPTION | Update package corruption particularly in the component store. |
42-
| 800F0900 | CBS_E_XML_PARSER_FAILURE | Generic XML parsing failure – may indicate serious servicing issues. |
33+
| 8007000D | ERROR_INVALID_DATA | The data is invalid. Typically caused by corrupted Windows Update metadata. |
34+
| 800705B9 | ERROR_XML_PARSE_ERROR | XML parsing error. Can be related to servicing stack corruption. |
35+
| 800736B3 | ERROR_SXS_ASSEMBLY_NOT_FOUND | Assembly not found. Commonly caused by component store corruption. |
36+
| 80073701 | ERROR_SXS_ASSEMBLY_MISSING | A component is missing. Typical for servicing or component store errors. |
37+
| 80073712 | ERROR_SXS_COMPONENT_STORE_CORRUPT | Component store is corrupted. |
38+
| 800F080D | CBS_E_MANIFEST_INVALID_ITEM | Invalid CBS manifest. Points to component corruption. |
39+
| 800F081F | CBS_E_SOURCE_MISSING | Missing source files. Windows can't find the files to complete the update. |
40+
| 800F0830 | CBS_E_IMAGE_UNSERVICEABLE | Image unserviceable. Often requires a repair or IPU. |
41+
| 800F0831 | CBS_E_STORE_CORRUPTION | Update package corruption (particularly in the component store). |
42+
| 800F0900 | CBS_E_XML_PARSER_FAILURE | Generic XML parsing failure. Might indicate serious servicing issues. |
4343
| 800F0904 | CBS_E_MORE_THAN_ONE_ACTIVE_EDITION | Invalid configuration in update metadata. |
44-
| 800F0982 | PSFX_E_MATCHING_COMPONENT_NOT_FOUND | Often appears with cumulative update failures. |
44+
| 800F0982 | PSFX_E_MATCHING_COMPONENT_NOT_FOUND | Often associated with cumulative update failures. |
4545
| 800F0984 | PSFX_E_MATCHING_BINARY_MISSING | Matching component directory exists but binary is missing. |
46-
| 800F0985 | PSFX_E_APPLY_REVERSE_DELTA_FAILED | May relate to missing manifests or payloads. |
46+
| 800F0985 | PSFX_E_APPLY_REVERSE_DELTA_FAILED | Possibly related to missing manifests or payloads. |
4747
| 800F0986 | PSFX_E_APPLY_FORWARD_DELTA_FAILED | Often requires servicing stack repair or IPU. |
4848
| 800F0987 | PSFX_E_NULL_DELTA_HYDRATION_FAILED | Package corruption or integration failure. |
49-
| 800F0988 | PSFX_E_INVALID_DELTA_COMBINATION | May be tied to specific update branch or delta patch issues. |
50-
| 800F0989 | PSFX_E_REVERSE_DELTA_MISSING | Seen during cumulative update failuresIPU may be the only resolution. |
49+
| 800F0988 | PSFX_E_INVALID_DELTA_COMBINATION | Possibly related to specific update branch or delta patch issues. |
50+
| 800F0989 | PSFX_E_REVERSE_DELTA_MISSING | Seen during cumulative update failures. IPU might be the only resolution. |
5151
| 800F0922 | CBS_E_INSTALLERS_FAILED | Processing advanced installers and generic commands failed. |
52-
| 800F0805 | CBS_E_INVALID_PACKAGE | Package is invalid – commonly a download or metadata corruption issue. |
52+
| 800F0805 | CBS_E_INVALID_PACKAGE | Package is invalid. Typically a download or metadata corruption issue. |
5353
| 800F0991 | PSFX_E_MISSING_PAYLOAD_FILE | Associated with update sequencing or dependency errors. |
54-
| 800F0905 | CBS_E_NO_ACTIVE_EDITION | E_DO_INHERITANCE_CONTEXT_NEEDE |
55-
| 8007371B | ERROR_SXS_TRANSACTION_CLOSURE_INCOMPLETE | Servicing operation incomplete or aborted. |
56-
| 80242016 | WU_E_UH_POSTREBOOTUNEXPECTEDSTATE | The state of the update after its post-reboot operation has completed is unexpected. |
57-
| 800F0911 | CBS_E_SOURCE_MODIFIED | The package sources have been modified/moved in a previous session and will need to be re-downloaded. |
58-
| 80071AB1 | ERROR_LOG_GROWTH_FAILED | An attempt to create space in the transactional resource manager's log failed. |
54+
| 800F0905 | CBS_E_NO_ACTIVE_EDITION | E_DO_INHERITANCE_CONTEXT_NEEDE |
55+
| 8007371B | ERROR_SXS_TRANSACTION_CLOSURE_INCOMPLETE | Servicing operation is incomplete or aborted. |
56+
| 80242016 | WU_E_UH_POSTREBOOTUNEXPECTEDSTATE | The state of the update after its post-reboot operation was completed is unexpected. |
57+
| 800F0911 | CBS_E_SOURCE_MODIFIED | The package sources have been modified or moved in a previous session and must be redownloaded. |
58+
| 80071AB1 | ERROR_LOG_GROWTH_FAILED | An attempt to create space in the transactional resource manager's log failed. |
5959

6060
```output
6161
Example of error 0x80073712 - ERROR_SXS_COMPONENT_STORE_CORRUPT
@@ -75,42 +75,39 @@ Example of error 0x80073712 - ERROR_SXS_COMPONENT_STORE_CORRUPT
7575
2025-02-27 08:58:35, Info CBS Not able to query DisableWerReporting flag. Assuming not set... [HRESULT = 0x80070002 - ERROR_FILE_NOT_FOUND]
7676
```
7777

78-
### Root Cause
78+
### Cause
7979

80-
Your Azure virtual machine (VM) is experiencing internal corruption in the Windows servicing stack. This stack is responsible for managing updates and system components. When it becomes damaged due to missing files, invalid configurations, or corrupted metadata, Windows can no longer apply updates or service the OS properly.
80+
The Azure VM is experiencing internal corruption in the Windows servicing stack. This stack is responsible for managing updates and system components. When it becomes damaged because of missing files, an invalid configuration, or corrupted metadata, Windows can no longer apply updates or service the OS correctly.
8181

8282
## Resolution for Azure VMs
8383

84-
To resolve this issue, Microsoft recommends performing an **in-place upgrade** of the Windows Server OS within the Azure VM. This process reinstalls the OS while preserving your data, apps, and settings.
84+
To resolve this issue, we recommend that you perform an in-place upgrade of Windows Server within the Azure VM. This process reinstalls the OS while preserving your data, apps, and settings.
8585

86-
### Instructions for how to troubleshoot
86+
### Instructions for troubleshooting
8787

88-
1. **Review the prerequisites**
89-
1. Ensure you have **Administrative Access** to the VM.
90-
1. Confirm the VM is running in Azure.
88+
1. Review the prerequisites:
89+
1. Make sure that you have administrative access to the VM.
90+
1. Verify that the VM is running on Azure.
9191

92-
2. **Back up your VM**
93-
1. Use **Azure Backup** or take a **snapshot** to ensure you can restore the VM if needed.
92+
2. Back up the VM. Use Azure Backup or take a snapshot to make sure that you can restore the VM, if it's necessary.
9493

95-
3. **Check for Errors**
96-
1. Review the following logs for known error codes:
97-
1. `CBS.log`
98-
1. `CbsPersist_*.log`
99-
1. `CbsPersist_*.cab`
94+
3. Review the following logs for known error codes:
95+
- `CBS.log`
96+
- `CbsPersist_*.log`
97+
- `CbsPersist_*.cab`
10098

101-
4. **Perform an OS upgrade**
102-
1. Follow the [In-place upgrade for VMs running Windows Server in Azure](/azure/virtual-machines/windows-in-place-upgrade) guidance.
99+
4. Follow the guidance in [In-place upgrade for VMs running Windows Server in Azure](/azure/virtual-machines/windows-in-place-upgrade).
103100

104-
5. **Run the Upgrade**
105-
1. From the elevated command prompt, change to **drive with ISO**.
106-
1. Type setup.exe /auto upgrade /dynamicupdate disable without quotes
107-
Choose **Keep personal files and apps** when prompted.
108-
Follow the on-screen instructions to complete the upgrade.
101+
5. Run the upgrade:
102+
1. At an elevated command prompt, change to **drive with ISO**.
103+
1. Enter setup.exe /auto upgrade /dynamicupdate disable.
104+
1. When you're prompted, select **Keep personal files and apps**.
105+
1. Follow the on-screen instructions to complete the upgrade.
109106

110-
6. **Post-Upgrade Checks**
107+
6. Post-upgrade checks
111108
1. Verify system functionality.
112-
1. Reapply any custom configurations or policies if needed.
113-
1. Re-enable services like **Azure Backup** or **monitoring agents** if they were paused.
109+
1. Reapply any custom configurations or policies as necessary.
110+
1. Re-enable any services, such as **Azure Backup** or **monitoring agents**, if they were paused.
114111

115112
## References
116113

0 commit comments

Comments
 (0)