Windows Server 2019 — MSI install rolls back at completion stage due to custom action failure — 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

MSI install on Windows Server 2019 reaches the finalisation step then rolls back, leaving target server without the application.

Environment & Reproduction

Observed when a deferred custom action returns non-zero during InstallFinalize, triggering full rollback.

msiexec /i payload.msi /qn /l*vx C:logsrollback.log

Root Cause Analysis

A custom action script or executable exits with an error after most files are copied, prompting the installer to undo all changes.

Quick Triage

Search the log for ‘Rolling back action’ and identify which custom action failed first.

Select-String -Path C:logsrollback.log -Pattern 'Rolling back action|CustomAction.*returned'

Step-by-Step Diagnosis

Re-run the failing custom action manually to capture its real error.

powershell -File C:WindowsInstallerMSI_extractpost-install.ps1
Get-EventLog -LogName Application -Source MsiInstaller -Newest 20

Solution — Primary Fix

Fix the custom action prerequisite (path, credential, registry) and re-run the install with the corrected environment.

# Example: pre-create the missing folder the CA expects
New-Item C:ProgramDataAppService -ItemType Directory -Force
msiexec /i payload.msi /qn /l*vx C:logsrerun.log

Solution — Alternative Approaches

Patch the MSI with a transform that disables the failing custom action when it is non-essential.

msiexec /i payload.msi TRANSFORMS=disablePostStep.mst /qn

Verification & Acceptance Criteria

Install completes without rollback and application service starts normally.

Get-Service AppService
Get-ItemProperty 'HKLM:SOFTWAREVendorApp'

Rollback Plan

Restore from system state backup if a partial change left the OS in inconsistent state.

wbadmin start systemstaterecovery -version:

Prevention & Hardening

Author custom actions with proper logging, idempotency, and rollback handlers to avoid full unwinds.

# In WiX: schedule CA in InstallExecuteSequence with rollback CA pair

Related Errors & Cross-Refs

Related: error 1603 fatal install, deferred CA permission failures, and ICE validation warnings.

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 rollback semantics and custom action authoring.