Windows Feature Upgrade Guidelines
The purpose of these guidelines is to troubleshoot Windows Feature Upgrade issues.
Most of the actions are recommended by Microsoft, and are not specific to CapaWinUpgrade.
💡 It is always recommended to reboot the workstation after having performed one of the actions below.
Common Solutions
Section titled “Common Solutions”Click here to expand...
Free up disk space
The upgrade packages check for at least 15 GB of free disk space in the “PreUpgrade” phase, but many feature upgrades need more than that to complete. Make sure the endpoint has at least 50 GB of free disk space before you retry the upgrade.
To free up disk space:
- Run Disk Cleanup and select Clean up system files to remove old Windows Update and feature upgrade files.
- Uninstall software that isn’t used.
- Move large personal files off the device, for example to OneDrive.
Unplug external devices
Disconnect all external devices that are not strictly necessary.
Update hardware drivers
Update all hardware drivers and execute the command below, from an elevated command prompt, to clean the driver store.
rundll32.exe pnpclean.dll,RunDLL_PnpClean /DRIVERS /MAXCLEANUpdate Windows
Download and install all available updates from Windows Update, including optional updates.
Uninstall security software
Uninstall third-party antivirus and security software.
Use the newest installation files
Always use the newest content package available.
Uncommon Solutions
Section titled “Uncommon Solutions”Click here to expand...
Upgrade BIOS
Upgrade the system BIOS and related firmware.
Repair System Files
Repair the system files by executing the commands below, in the specified order, from an elevated command prompt.
DISM.exe /Online /Cleanup-image /RestorehealthSFC.exe /scannowDisable Roaming User Profiles
Disable roaming user profiles and folder redirection to ensure that user profiles are stored in C:\Users.
Rare Solutions
Section titled “Rare Solutions”Click here to expand...
Delete Obsolete User Profiles
Delete obsolete user profiles from the workstation.
Known Package Issues
Section titled “Known Package Issues”Click here to expand...
Errorlevel 1 from the PrintToPDF step
An upgrade package fails on some endpoints, and the client log shows:
Run cmd.exe /c C:\WINDOWS\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -command "Disable-WindowsOptionalFeature -Online -NoRestart -FeatureName Printing-PrintToPDFServices-Features"Run returns errorlevel '1'The upgrade packages call CapaWinUpgrade_DisablePrintingFeatures() to disable the Printing-PrintToPDFServices-Features Windows feature. This was a workaround for an old Windows issue that Microsoft has since fixed. On affected endpoints the step now fails with errorlevel 1 and stops the upgrade.
The step is in all four upgrade packages. They differ only in how they run the upgrade. The packages are Force Upgrade, Force Upgrade with Reboot, Publish Upgrade, and Push Upgrade. Apply the fix to the package you use. For the differences between them, see CapaWinUpgrade - Computer Packages.
To remove the step:
-
Open the installation script of the affected upgrade package.
-
Find this line:
If bStatus Then bStatus=CapaWinUpgrade_DisablePrintingFeatures() -
Comment it out:
'If bStatus Then bStatus=CapaWinUpgrade_DisablePrintingFeatures() -
Save the script, rebuild the package, and redeploy it to the affected endpoints.
Various Information
Section titled “Various Information”Click here to expand...
Command line vs. graphical user interface
The upgrade process behaves differently, depending on whether you run it using command line options or using the graphical user interface.
This causes many people to consider the upgrade process to be “unstable” when using the command line.
The CapaWinUpgrade service provided by CapaSystems uses command line options to perform upgrades, and is also affected by the circumstances described above.
SetupDiag logs for a failed or rolled-back upgrade
When a feature upgrade fails or rolls back to the previous build, CapaWinUpgrade saves the SetupDiag logs in this archive:
C:\Program Files\CapaInstaller\Client\Logs\CapaWinUpgrade\SetupDiag\<timestamp>\Logs.zipAttach this archive when you contact CapaSystems support about a failed upgrade.
References
Related
Section titled “Related”- Windows 11 In-Place Upgrade Is Stuck — a specific stuck-upgrade issue from 2023
- CapaWinUpgrade - Computer Packages — the Check PreRequisites package that runs the compatibility scan
- CapaWinUpgrade Installation Screen Error — troubleshooting a failing installation screen