Share via

BDD 2007 - Understanding BDD logs

  • Article

Before you can troubleshoot BDD 2007 you need to clearly understand the many logs used during an OS deployment.

If you understand what log to refer to and at what time you will find things that where once mysterious become understandable.

With this in mind I thought I would provide this quick guide to BDD logs.

BDD scripts automatically create log files. Each script creates a log file that matches the name of the script, for example ZTIGather.wsf creates a log file named ZTIGather.log. Each script also updates a common log file (BDD.log) that aggregates the contents of logs created by the BDD scripts.  BDD logs are located in the C:\MININT\SMSOSD\OSDLOGS folder during the deployment process. They are then moved at the completion of a deployment, their destination is dependent on the deployment type:

  • Lite Touch -  C:\WINDOWS\TEMP\BDDLogs unless the /debug:true option has been specified.
  • Zero Touch - C:\TEMP\SMSOSD or C:\SMSOSD unless the C:\MININT\Archive_OSD.SMS file is found.

The BDD.log file is also copied to a network location at the end of the deployment if the SLShare value is specified in the Customsettings.ini.

The BDD log format is designed to be read by TRACE32, part of the SMS 2003 Toolkit 2 - download here. I would strongly recommend that you use this tool whenever possible to read the logs as it makes finding errors much easier.

 

The rest of this blog details the log files that are created during the deployment and examples of when they can be used when troubleshooting.

BDD logs

Bdd.log - The aggreated BDD log file.

<Scriptname>. log - A log file created by each BDD script.

Wizard.log -   Updated by BDD wizards.

DeployUpdates_platform.log - Created when deployment points are updated. Also used when updating Windows PE. Useful when troubleshooting Windows PE driver integration issues. This log is located in the %temp% folder.

SMSTS.log - Logs all of the transactions for the Task Sequencer. This will be located in %TEMP% , C:\Windows\System32\ccm\logs, or C: \SMSTSLog, depending on the situation.

WPEinit.log - Logs the Windows PE intialisation process - Useful for troubleshooting error starting windows PE

USMT Logs

BDD 2007 automatically adds the logging switches to save the USMT logs to the BDD log file location

USMTEstimate.log - Log created when estimating the USMT requirements

USMTCapture.log - Log created when capturing data

USMTRestore.log - Log created when restoring data

Windows setup logs

Vista

This is a subset of the log files that are most useful for troubleshooting deployment issues, for more detailed information about Vista setup log files refer to this KB - https://support.microsoft.com/kb/927521.

setupapi.dev.log - Windows setup log, located in C:\Windows\inf - Useful for investigating failed Driver installations.

setupact.log - Windows setup log, located in C:\Windows\panther -  Useful for investigating failed installations.

setuperr.log - Windows setup log, located in C:\Windows\panther - contains a list of errors that occurred during installation.

netsetup.log - Windows setup log, located in C:\Windows\Debug - useful for troubleshooting domain join issues.

XP

setupapi.log - Windows setup log, located in C:\Windows - record inf installation actions - useful for investigating failed driver installations.

setupact.log - Windows setup log, located in C:\Windows - Lists installation actions.

setuperr.log - Windows setup log, located in C:\Windows - Details installation errors.

netsetup.log - Windows setup log, located in C:\Windows\Debug, useful for troubleshooting domain join issues.

OSD logs

The following logs are created during the deployment phases, these logs are located in the C:\MININT\SMSOSD\OSDLOGS folder:

OSDAgent.log - This is the primary log and should be the first place you look to determine what step failed

OSDEnv.log - Indicates which OSD environment variables are set

OSDInstallWIM.log - Logs image installation options

IDUser.log - User notification log

IDUserNotification.log - User notification log

MachineState.log - Logs computer state migration information (computer name, IP Address, Registered Owner/Org

WinPEInstall.log - WinPE installation information

Exec.log - Logs ‘Run SWD Program’ actions

scanstate.log - USMT scanstate log

OSDLaunch.log - OSD Bootstrap - May contain errors if the Advanced Client Network Access account is not configured correctly.

SMSCMT.log - Logs SMS Client migration information (site code, client GUIID)

WinPEInstall.log -Windows PE installation information.

OSDInstallWizard.log - Logs start-up operations.

OSDShell.log - Launches the OSD Install Wizard.

OSDSWDProgramExec.log – Logs Run SWD Program Actions.

OSDUsmtScanstate.log – Logs Capture User State operations

OSDUsmtLoadstate.log - Logs Restore User State operations

OSDBootstrap.log - May contain errors if the Advanced Client Network Access account is not configured correctly.

Note: The C:\minint folder is lost during the disk partitioning process. If you need to trobleshoot issues that occur before this point then disable the disk partitioning task in the task sequencer.

Disclaimer: The information on this site is provided "AS IS" with no warranties, confers no rights, and is not supported by the authors or Microsoft Corporation. Use of included script samples are subject to the terms specified in the Terms of Use .

Comments

  • Anonymous
    January 01, 2003
    I am very happy with the progress of the deployment guys blog so far. Hopefully you all agree that we

  • Anonymous
    January 01, 2003
    When developing a build it is often useful to have it in debug mode. Debug mode is when log content is

  • Anonymous
    January 01, 2003
    Hi Simon, Contact me via email on ben.hunter at microsoft.com and I can forward you some information on this issue.

  • Anonymous
    January 01, 2003
    Hi Rich, This is most likely caused by one of two issues:

  1. The image HAl does not match the hardware you are applying it to.
  2. The image does not contain the correct storage drivers. Is the HAL type correct? Thanks, Ben

  • Anonymous
    January 01, 2003
    This is caused by the way that BDD decides on the name for the log file. You will need to update the copylog function replacing the "HostName" variable with "COMPUTERNAME". Please note that I generally don't recommand updating any of the core BDD files but if you are really keen then here is the updated section of the copylog function: If oEnvironment.Item("OSDCOMPUTERNAME") <> "" and Instr(oEnvironment.Item("OSDCOMPUTERNAME"), ":") = 0 then sComputer = oEnvironment.Item("OSDCOMPUTERNAME") ElseIf oEnvironment.Item("OSDNEWMACHINENAME") <> "" then sComputer = oEnvironment.Item("OSDNEWMACHINENAME") ElseIf oEnvironment.Item("OSVersion") = "WinPE" then sComputer = oEnvironment.Item("OSDCOMPUTERNAME") re.Pattern = ":" sComputer = re.Replace(sComputer, "") Else sComputer = oEnvironment.Item("COMPUTERNAME") End if Thanks, Ben

  • Anonymous
    January 01, 2003
    you mighthave a look at the following two blogs I have posted previously, they detail how to integrate the intel storage drivers. https://blogs.technet.com/benhunter/archive/2007/06/29/bdd-2007-intel-mass-storage-drivers-iastor.aspx http://blogs.technet.com/benhunter/archive/2007/07/12/bdd-2007-integrating-mass-storage-drivers-into-your-xp-image.aspx Thanks, Ben

  • Anonymous
    January 01, 2003
    You simply import the drivers into the deployment workbench. Then when you update the deployment point BDD will automatically integrate them into Windows PE 2.0. Are you sure that Windows PE 2.0 does not include the Intel sata drivers? I have had no issues.

  • Anonymous
    January 01, 2003
    Hi Ben, I have 2 images. I have a deployment point and a task sequence for each. Both images use the same DB for my make and models. One of my models, a Panasonic CF51R, when imaged with the first image, everything installs properly. When imaged with the second image, the modem will not install (an application added under the application tab in that make/modem in the DB)and gives a return code: -1073741818. The application for the modem simply runs the install file "HXFSetup.exe". This is a silent install and when run manually from the resource$ folder, it installs fine. It just won't install during the image process. Any thoughts/suggestions? Thanks Kelly

  • Anonymous
    January 01, 2003
    Hi Kelly, In theory it should run. Unfortunately there are many issue that could be causing this problem. Thanks, Ben

  • Anonymous
    January 01, 2003
    Q. What log files can be evaluated to troubleshoot deployment issues with Windows Vista? A. The primary

  • Anonymous
    June 21, 2007
    Hello, nice tutorial would you please explain how to use bdd/winpe 2.0 with drivers. how to integrate sata drivers in offline wim-image. the most annoying this is that intel sata drivers are not incluede in winpe 2.0 by default. When we apply wim image through bdd the computer reboots without warning. no accesible boot device found. no support for realtek ac97 sound and maaannnyyy others.... many thanks in advance. Grub3r

  • Anonymous
    June 26, 2007
    I've had loads of issues re SATA drivers on HP laptops. They're a complete nightmare.

  • Anonymous
    October 11, 2007
    The comment has been removed

  • Anonymous
    October 24, 2007
    The comment has been removed

  • Anonymous
    April 04, 2008
    Ben, Great site, When I update drivers on my BDD , then update the deployment point, it completes without any errors, but when I push the image to the test machine it runs the script , restarts then hangs.  What could be the issue here, Thank you

  • Anonymous
    April 28, 2008
    thanks for your feedback, but I'm not sure where to check to see if the HAL type is correct. Thank you