Hello AJ, Korr,
Are there any good reference links/pages/docs on how to read and parse a detailed install log - especially to figure out what, specifically caused the (MSI) installation to fail?
For this, you can have a look on the Microsoft
"Logging of Action Return Values" article which illustrates what values are written in the log file when an action returns a specific error code. What you are looking for is, as you have already said, the value "3" which indicates that an action has failed.
I'm not even entirely sure if the log is all Windows Installer's output, or if it is AI's output, or a combination of the two.
The log is generated entirely by the Windows Installer service but, additionally to the standard actions, it also logs the actions related to Advanced Installer (these actions look something like: AI_ACTION).
I'm used to seeing log output with "severity" noted in the output, but there's really none of that. Given that Windows Installer will "rollback" a failed install, I am theorizing that the cause of the failure will be somewhere "in the middle" of the log, and then we'd see all the rollback "actions" taking place.
The rollback actions are used when the application is installed, but something went wrong and the installation must be rolled back. While the installation script is executed (
during the deferred sequence), the installer builds a rollback script.
But there's no demarcation of "phases" or anything like that to really tell me where to focus.
Here is a little guide which I hope will help you differentiate the stages (in the log file):
- As you may already know, there are two installation stages:
Wizard Dialogs Stage and
"Install Execution Stage". The beginning of the "Install Execution Stage" is marked by the execution of the
"ExecuteAction" action. Another useful way to differentiate the stages is to watch where the process is held:
- it can be either held on
"client", e.g.: MSI
(c) (D0:AC) [17:13:20:440]: Doing action: ProgressDlg
- or it can be held on
"server", e.g.: MSI
(s) (74:90) [17:13:31:033]: Doing action: AppSearch
In this particular log, I am guessing that this might be relevant, and I should look just above it?
Action ended 11:20:45: INSTALL. Return value 3.
Yes, you are right, that is relevant. And yes, you should look above it. The "INSTALL" action is, indeed, the standard installation action. The reason why it failed is (most probably) because another action failed (i.e. a custom action).
If anyone knows of some good links (AI or general) that will help me understand the log, I'd really appreciate it.
Beside what I have wrote above, you can also have a look on our
"How Do I Read a Windows Installer Verbose Log File?".
@Korr,
Thank you for contributing to our forums. I am sure the information will be useful for further users looking for some additional information about Windows Installer logging.
Hope this helps.
All the best,
Catalin