Edit

Share via


Wilogutl.exe

Wilogutl.exe assists the analysis of log files from a Windows Installer installation, and it displays suggested solutions to errors that are found in a log file.

Non-critical errors are not displayed. Wilogutl.exe can be run in quiet mode or with a user interface (UI). The tool generates reports as text files in both the UI and quiet modes. It works best with verbose Windows Installer log files, but also works with non-verbose logs. For more information, see Logging.

This tool is only available in the Windows SDK Components for Windows Installer Developers.

Syntax

wilogutl.exe [<options>][<source file>][<options>][<report file directory>]

You can use the following command lines to run in quiet mode.

wilogutl /q /l c:\mymsilog.log /o c\outputdir\

wilogutl /q /l c:\mymsilog.log

Command-Line Options

Wilogutl.exe uses the following case insensitive command-line options. A dash delimiter can be used in place of a slash.

Option Description
none Runs in UI mode—without command-line options.
/q Specifies the quiet mode. Wilogutl.exe generates report files and does not display a user interface.
/l Specifies the name of the log file to be analyzed. This option is required when using the quiet mode.
/o Specifies the output directory for report files. This output path is used only when running in quiet mode. If the option is not present, the reports are put in the C:\WiLogResults directory.

 

When run in UI mode, Wilogutl.exe displays the following dialog boxes.

Name Description
Windows Installer Verbose Log Analyzer The Windows Installer Verbose Log Analyzer dialog box enables users to select a log file for analysis:
  • The Open button opens the file in Notepad. The preview area can be used to verify that the correct log file has been selected.
  • The Analyze button begins log file analysis and displays the Detailed Log File View dialog box.
Detailed Log File View The Detailed Log File View dialog box displays logged error information. Use the Back and Next buttons to navigate through multiple errors. To display non-critical errors select the Show Ignored Debug Errors check box. The installer version on the computer used to run the logged installation is displayed. If the logged installation was run with elevated permissions, the Elevated install check box is selected and information is provided in the Client Side Privilege Details and Server Side Privilege Details text boxes. The Detailed Log File View dialog box contains the following buttons:
  • States - Show the Feature and Component States dialog box.
  • Properties - Show the Properties dialog box.
  • Policies - Show the Policies dialog box.
  • HTML Annotated Log - Show log as annotated HTML file.
  • Save Results - Save report files to specified directory.
  • Error Message Help - Show installer error message help.
  • Help - Show help for Windows Installer Setup Log Analyzer.
  • How to Read a Log File - Show the log file help document.
Feature and Component States The Feature and Component States dialog box displays the states of features and components:
  • The Feature column shows the name for the feature in the installation package.
  • The Component column shows the name of the component in the installation package.
  • The Installed column shows the feature or component's state at the end of the installation.
  • The Request column shows the user's selection during the installation for the feature or component's state.
  • The Action column shows the action taken by the installer for the feature or component.
For more information, see MsiGetComponentState and MsiGetFeatureState.
Properties The Properties dialog box shows Windows Installer Properties and their values at the end of the installation. You can sort the properties by name or by value:
  • The Client tab shows properties and values during the client side portion of the installation.
  • The Server tab shows properties and values during the server portion of the installation.
  • The Nested tab shows the properties and values of any Concurrent Installations.
Policies The Policies dialog box displays the System Policy set after the installation:
  • A value of 0 (zero) set for the policy means the policy is not enabled.
  • A value of 1 (one) means the policy is enabled.
  • A value of ? (question mark) means the policy value is not recorded in the log.
If you need a policy value that is not in the log, try using Regedit.exe to check the registry keys on the computer failing the installation.

 

Report Files

When performing a quiet mode analysis or clicking the Save Results button on the Detailed Log File View dialog, the Windows Installer Setup Analyzer tool generates three text files and an HTML annotated log file.

The following table identifies the names and contents in the report files.

Name Description
logfilename_summary.txt Summarizes the log file. Lists the information displayed by the Detailed Log File View dialog box and the first error.
logfilename_errors.txt Identifies the number of errors, the errors, and recommended solutions. This file lists both critical and non-critical errors.
logfilename_policies.txt Identifies the policy names and values set at the end of the installation as in the Policies dialog box.
details_logfilename.htm An HTML annotated log with a legend for the color coding.

 

Return Values

If invalid command-line arguments are passed for quiet mode operations, Wilogutl.exe does nothing, and the process returns one of the values in the following table.

Value Meaning
1 Bad output directory is specified.
2 Bad log file name is specified.
3 Passed /q, but is missing the required switch /l for the log file name.
4 Passed /l, but is missing the required switch /q for quiet mode.

 

Released Versions, Tools, and Redistributables

Windows Installer Development Tools