Windows Server 2019 — Custom MSI authoring fails ICE validation in build pipeline — Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution — Primary Fix
7. Solution — Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

WiX build on Windows Server 2019 build agent fails with ICE validation errors that block release of internal MSI packages.

Environment & Reproduction

Reproduces when light.exe runs full ICE validation on a package that uses overlapping component IDs or invalid sequencing.

light.exe -nologo -ext WixUIExtension product.wixobj

Root Cause Analysis

ICE rules detect structural issues such as duplicate components, invalid table relationships, or unsequenced custom actions.

Quick Triage

Capture the exact ICE codes emitted and consult their documented meaning.

light.exe -ext WixUIExtension product.wixobj -out product.msi 2> ice.log
Select-String -Path ice.log -Pattern 'ICEd+'

Step-by-Step Diagnosis

Re-run with verbose validation flag to map errors to source lines.

light.exe -v -ext WixUIExtension product.wixobj

Solution — Primary Fix

Fix duplicate component definitions, supply missing scheduling, and rebuild the MSI.

# Edit product.wxs: ensure unique Component Id and Directory ref
candle product.wxs
light -ext WixUIExtension product.wixobj -out product.msi

Solution — Alternative Approaches

Suppress non-critical ICEs only when the underlying behaviour is intentional and reviewed.

light.exe -sice:ICE57 product.wixobj

Verification & Acceptance Criteria

light.exe completes without errors and resulting MSI installs cleanly on a test server.

msiexec /i product.msi /qn /l*v test.log

Rollback Plan

Revert WiX source changes via source control if validation tightening breaks other modules.

git revert HEAD

Prevention & Hardening

Run ICE validation in pre-merge builds and treat new ICE warnings as failures.

# Pipeline step: light -ext WixUIExtension -fatalwarning

Related Errors & Cross-Refs

Related: MSI install rollback, custom action sequencing errors, and SmokeTest validation failures.

Related tutorial: View the step-by-step tutorial for Windows Server 2019.

View all Windows Server 2019 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Microsoft Learn documentation for Windows Installer ICEs and WiX toolset validation.