44.8 Enabling Windows Installer Verbose Logging

When you distribute an application based on an MSI package rather than an AOT/AXT package, Application Launcher launches the Microsoft Windows Installer so that it can install the application according to the information and files in the MSI package. By default, the Windows Installer creates an msixxxxx.log file that includes basic information and messages.

If you need to troubleshoot problems with the installation, you can set up verbose logging for the Windows Installer. The Windows Installer creates a log file, zappmsi.log, in the user's temporary directory on the workstation. Enabling verbose logging will slow down installation of MSI applications, so you should do it only as a troubleshooting procedure.

To enable verbose logging on a workstation:

  1. Modify the Windows registry to add the following key:

    HKEY_LOCAL_MACHINE\Software\NetWare\NAL\1.0\Debug
    
  2. Under the Debug key, add a DWORD value. Set the value name to MSI and the value data to 1.

  3. Save the registry.

  4. Restart the workstation.

You need to modify the registry of each workstation where you want to enable verbose logging. We recommend that you create an Application object whose only function is to modify the registry.

For information about Windows Installer error messages included in the msixxxxx.log file or the zappmsi.log file, see the Windows Installer Error Messages document at the Microsoft Developer Network (MSDN) site.

For information about Windows Installer error codes returned through Application Launcher, see the Error Codes document at the Microsoft Developer Network site.