Checking the Installation of Features, Components, Files

Windows Installer

Checking the Installation of Features, Components, Files

If after running an installation, you need to verify that a particular feature, component, or file has been installed, turn on the verbose logging option during the installation. See Windows Installer Logging and Command Line Options.

The verbose log includes an entry for each feature and component the installation package may install. The log tells what the state of that feature or component was prior to the installation, what state was requested by the installation, and in what state the installer left the feature or component. Feature and component entries in the log appear as the following examples.

MSI (s) (40:A4): Feature: QuickTest; Installed: Absent;   Request:
 Local;   Action: Local
MSI (s) (40:A4): Component: QuickTest; Installed: Absent;   Request:
 Local;   Action: Local

This verbose log indicates that:

  • the installation state of the QuickTest feature and component was absent before running the package
  • the package requested a local installation of these
  • the feature and component were both left in the locally installed state after running the package.

The label "Installed" in the log refers to the current install state of the feature or component, "Request" refers to the requested install state of the feature or component. "Action" refers to the actual action state of the feature or component.

The following table lists the possible component or feature states that can appear in the log.

Log Entry Description
Request: Null No request.
Action: Null No action taken.
Installed: Absent Component or feature is not currently installed.
Request: Absent Installation requests component or feature be uninstalled.
Action: Absent Installer actually uninstalls component or feature.
Installed: Local Component or feature is currently installed to run local.
Request: Local Installation requests component or feature be installed to run local.
Action: Local Installer actually installs component or feature to run local.
Installed: Source Component or feature is currently installed to run from source.
Requested: Source Installation requests that component or feature be installed to run from source.
Action: Source Installer actually installs the component or feature to run from source.
Installed: Advertise Feature is currently advertised. Components are never advertised.
Request: Advertise Installation requests feature be installed as an advertised feature.
Action: Advertise Installer actually installs the feature as an advertised feature.
Request: Reinstall Installation requests feature be reinstalled. Components do not use reinstall state.
Action: Reinstall Installer actually reinstalls feature.
Installed: Current Feature is currently installed in the default authored install state.
Request: Current Installation requests feature be installed in the default authored install state.
Action: Current Installer actually installs the feature in the default authored install state.
Action: FileAbsent Installer actually uninstalls component's files and leaves all other resources of the component installed.
Action: HKCRAbsent Installer actually removes component's HKCR information. File and non-HKCR information remain.
Action: HKCRFileAbsent Installer actually removes component's HKCR information and files. All other resources of the component remain.

 

The verbose log has an entry for each file that may be installed by the package. The log tells what was done to the file and provides some explanation. File entries in the log appear as in the following example.

MSI (s) (40:A4): File: C:\Test\TESTDB.EXE;  Won't Overwrite;  Existing
 file is of an equal version

This log indicates that the installer will not overwrite the existing Testdb.exe file because the existing file is the same as the version being installed.

Note  If you need to author an installation package that searches for an existing file or directory on the user's computer during an installation, use the method described in Searching for Existing Applications, Files, Registry Entries or .ini File Entries.

Send comments about this topic to Microsoft

Build date: 8/13/2009

© 2009 Microsoft Corporation. All rights reserved.