Validating an Installation Database

Windows Installer

Validating an Installation Database

Authors of installation packages should always run validation on their packages before attempting to install the package for the first time and rerun validation whenever making any changes to the package. Validation scans the database for errors that may appear valid individually but that cause incorrect behavior in the context of the whole database. Attempting to install a package that fails validation can damage the user's system. See the sections Package Validation and Internal Consistency Evaluators - ICEs.

You can validate the sample package using Orca or Msival2.exe (both are provided with the Windows installer SDK). To view the help for Msival2.exe change directories and enter on the command line.

Msival2 -?

The .cub file darice.cub is also provided with the SDK. This file contains the ICE custom actions needed by Msival2.exe to perform validation. To validate the MNP2000.msi enter

msival2 MNP2000.msi Darice.cub

For a description of the error and warning messages returned by validation see the ICE Reference. Correct all the errors in the package and rerun validation as necessary until the package passes validation without errors.

Once the package passes validation, you can install the sample package by clicking on the MNP2000.msi icon or from the command line using the Command Line Options.

This completes the sample installation.

Next example

An Upgrade Example

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.