Exchange 2007: Setup Logs And How To Use Them To Troubleshoot Setup

This blog post goes into explanation of what are different log files that are created by Exchange setup and how to use them to troubleshoot setup issues. Prerequisite failures: If you fail a prerequisite condition, then the text will be logged to the console during the Exchange installation process. There are a couple of files […]

This blog post goes into explanation of what are different log files that are created by Exchange setup and how to use them to troubleshoot setup issues.

Prerequisite failures: If you fail a prerequisite condition, then the text will be logged to the console during the Exchange installation process. There are a couple of files that you should look at to troubleshoot the issue:

ExchangeSetup.log file:

  • Located at %SystemDrive%\ExchangeSetupLogs.
  • The parameters that were passed to BPA will be listed

For example:

[23:44:29] Executing [Test-SetupHealth ScanType:'PrecheckInstall' Role:'Gateway']...

BPA output file:

  • Located in ExchangeSetupLogs\PreReqs
  • The naming convention is: ExBPA.<datetime>.data.xml
  • The contents and structure of this file will closely resemble the ExBPA.Config.xml file. There will be one output XML file created for each call to Test-SetupHealth.

Information found in the EXBPA.config.xml file should help to determine why the prerequisite failed:

  1. To determine the parameters of setup navigate to the end of the second line of XML to see a Restrictions attribute.
  2. Within the <Message> elements you'll see the same text as what you saw logged to the console when setup failed
  3. Just above the <Message> element you will find the corresponding rule and conditions that were tested.

Reviewing Exchange setup logs: Exchange Server 2007 Setup logs are contained within the C:\ExchangeSetupLogs folder for all phases of the installation. The setup logs contain detailed information about setup process and steps. There are two primary logs files used: ExchangeSetup.log and ExchangeSetup.msilog. ExchangeSetup.log is the primary log to use while troubleshooting setup related issues.

ExchangeSetup.log: This log file is new to Exchange and contains more information about the tasks that are run in setup. In addition, data previously recorded in the Exchange Server Setup Progress.log, which was used in previous versions of Exchange, is now merged into the ExchangeSetup.log. The information contained in this log is information related to the configuration data. The ExchangeSetup.log is always logged with the timestamp of the local server.

ExchangeSetup.msilog: This log file contains information about the unpack phase of setup where the Microsoft Installer copies the binaries to place them on disk from the temporary location for use during setup; example:

[1/27/2007 3:54:34 PM] [0] Setup will run the task 'install-msipackage'
[1/27/2007 3:54:34 PM] [1] Setup launched task 'install-msipackage -logfile 'C:\ExchangeSetupLogs\ExchangeSetup.msilog' -targetdirectory 'C:\Program Files\Microsoft\Exchange Server' -features 'AdminTools','Bridgehead','ClientAccess','Mailbox','UnifiedMessaging' -packagepath 'D:\C drive desktop\Exchange 2007\685.25\amd64\exchangeserver.msi' -updatesdir 'D:\C drive desktop\Exchange 2007\685.25\amd64\Updates' -PropertyValues 'DISABLEERRORREPORTING=0 PRODUCTLANGUAGELCID=1033 DEFAULTLANGUAGENAME=ENU DEFAULTLANGUAGELCID=1033'' 
[1/27/2007 3:54:34 PM] [1] Beginning processing.
[1/27/2007 3:54:35 PM] [1] Installing MSI package 'D:\C drive desktop\Exchange 2007\685.25\amd64\exchangeserver.msi'.
[1/27/2007 3:56:46 PM] [1] Ending processing.
[1/27/2007 3:56:46 PM] [0] **************

Breaking out the pieces of the ExchangeSetup.log: The ExchangeSetup.log is broken out in subcomponents highlighting different levels (indents) of setup. These levels will be used for future parsers.

  • [0] – Begin main run of a particular task
  • [1] – High level run of a specific task
  • [2] – Subset of a particular task

Setup runs begin with the following marker:

[1/27/2007 2:45:28 PM] [0] **********************************************
[1/27/2007 2:45:28 PM] [0] Starting Microsoft Exchange 2007 Setup
[1/27/2007 2:45:28 PM] [0] **********************************************

Setup runs end with the following marker:

[1/27/2007 3:13:28 PM] [0] End of Setup
[1/27/2007 3:13:28 PM] [0] **********************************************

Example of a high level run and a subset of a particular task are:

[1/27/2007 4:13:57 PM] [1] Executing '$RoleTargetVersion = "8.0.685.25"', handleError = False
[1/27/2007 4:13:57 PM] [2] Launching sub-task '$error.Clear(); $RoleFqdnOrName = "servername.domain.com"'.

Identifying Key Information: The setup log contains key information that is useful in troubleshooting. Although searching the setup log can be tedious and difficult at first, with experience it becomes easier. The following are some key pieces of information to aid in deciphering the ExchangeSetup.log. These snippets are not sequential, but meant to illustrate the type of information being discussed.

Continue to read full article....

Microsoft, Exchange 2007, Server, Toubleshooting, knowldegebase, Setup, Logs, Setup Logs