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.
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
Wilogutl.exe uses the following case insensitive command-line options. A dash delimiter can be used in place of a slash.
|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.
|Windows Installer Verbose Log Analyzer||The Windows Installer Verbose Log Analyzer dialog box enables users to select a log file for analysis:|
|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:
|Feature and Component States||The Feature and Component States dialog box displays the states of features and components:|
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: |
|Policies||The Policies dialog box displays the
System Policy set after the installation: |
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.
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.
|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.|
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.
|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.|