Community Pick: Many members of our community have endorsed this article.
Editor's Choice: This article has been selected by our editors as an exceptional contribution.

SCCM OSD Basic troubleshooting

Hayes JupeIT Director
Microsoft infrastructure nerd with 20+ years experience. Australian based, but works worldwide.
SCCM 2007 OSD is a fantastic way to deploy operating systems, however, like most things SCCM issues can sometimes be difficult to resolve due to the sheer volume of logs to sift through and the dispersed nature of the blog posts that deal with some of these issues. This article will help SCCM OSD newbies with some of these issues.

[b]Integrating SCCM and MDT 2008[/b]
For our deployments, we always install MDT 2008 on our SCCM server and select Configure ConfigMgr Integration from the MDT area on the start menu. This gives us:

Templated task sequences we can import into SCCM
Additional TS Variables for use in our task sequences
Additional options and flexibility around computer backup, USMT etc.
For beginners, the template task sequences are a very quick way to get up and running while being guided through the process, while for more advanced users the additional functionality comes in handy when your task sequences become more complex.

[b]Setting yourself up[/b]
In order to have any chance at troubleshooting SCCM OSD issues, you need to do the following:


Install trace32.exe which is part of the SMS 2003 Toolkit 2
(download from Here)


Enable command line support within your boot images:
a.  Go to the properties of your boot image(s) (right click and choose Properties)
b.  Go to the Windows PE tab and tick the Enable command support (testing only) option.
c.  When prompted, click on Yes to update your distribution points.
d.  From within your boot image (Windows PE) environment, you can now press F8 to
     open up a command window -- very useful for troubleshooting


Be familiar with your OS setup log files (e.g. WindowsXP has setupapi.log, netsetup.log etc.)[b]Log files[/b]
The root of all Task Sequence troubleshooting is called smsts.log -- and this log is always the first step to troubleshooting any TS issue -- if you have an issue, look in here first!

Unfortunately, the smsts.log can be stored in one of 7 locations, depending on the stage of the build and the architecture of the OS:
WindowsPE, before HDD format:
WindowsPE, after HDD format:
      x:\smstslog\smsts.log and copied to c:\_SMSTaskSequence\Logs\Smstslog\smsts.log
Full version windows, before SCCM agent installed:
Full version windows, after SCCM agent installed:
Full version x64 windows, after SCCM agent installed:
After Task Sequence has finished running
After Task Sequence has finished running(x64)
Information is also logged as SCCM client events, which can be viewed by running the SCCM report:
     Last 1000 messages for a specific computer (Errors, warnings and information)

As a general rule, the SMSTS.log provides more detail, however the SCCM client events are easier to read, and, for simple issues, can lead you to the root cause very quickly.

[b]PXE boot issues[/b]
In order to resolve PXE boot issues, there are two main log files we are interested in:

Pxecontrol.log -- which is located in the installation logs directory (eg C:\Program Files (x86)\Microsoft Configuration Manager\Logs\pxecontrol.log)
Smspxe.log -- which is located in MP logs directory (eg C:\Program Files (x86)\SMS_CCM\Logs\smspxe.log)
If this is the first time you've setup a PXE service point, I recommend you check pxecontrol.log, there should be lines similar to the following:
address to server list  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.248 2009 Cen. Australia Standard Time><thread=772 (0x304)>
                      adding address to server list  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.250 2009 Cen. Australia Standard Time><thread=772 (0x304)>
                      Sending availiability packet to:  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.252 2009 Cen. Australia Standard Time><thread=772 (0x304)>
                      Sent 274 bytes to  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.253 2009 Cen. Australia Standard Time><thread=772 (0x304)>
                      PXE test request succeeded.~  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.355 2009 Cen. Australia Standard Time><thread=772 (0x304)>
                      Successfully performed availability check against local computer.~  $$<SMS_PXE_SERVICE_POINT><Fri Jul 31 07:54:45.357 2009 Cen. Australia Standard Time><thread=772 (0x304)>

Open in new window

If you see otherwise, then, WDS or the PXE service point is not correctly installed.  Without going into too much detail in this area, as a catch-all fix:
Uninstall the pxe service point
Uninstall WDS
Install WDS, but DO NOT configure
Install the pxe service point
Re-check the pxecontrol.log
Another very common error is to see the following when trying to PXE boot:
PXE-T01: The specified file was not found
                      PXE-E3B:TFTP error -- File not found

Open in new window

This error is caused because you are missing files from your \remoteinstall\smsboot\x86 or x64 directory and is generally caused by one of two things:


The x64 boot image has not been added to the PXE service point.
"But I'm only deploying an x86  boot image and OS," I hear you say.  It doesn't matter.  If the machine is x64 architecture (which all today's new machines are), the boot ROM requested will be x64. This in no way effects your ability to use an x86 boot image; this boot ROM process is completely independent.
The solution is to add the x64 image to your PXE DP and update. You will then see the directory \remoteinstall\smsboot\x64 populated with files, and your good to go.


Even after you update your PXE DP, the files still don't show up.
This is a common issue.  When updating the DP, the WIM file is mounted (under C:\windows\temp), all your modifications injected (such as drivers, custom backgrounds etc) and then packed back up into the boot wim pushed to the DP.  At the same time, the boot ROM files were interested in are extracted to C:\Windows\temp\Pxebootfiles before being copied to \remoteinstall\smsboot\x86 or x64.  

Sometimes the C:\Windows\temp\Pxebootfiles directory has something funky happen to it and doesn't clean itself up correctly.  So the difficult fix is -- Delete the directory and re-distribute the package. (The directory is hidden, so make sure you set the option in Explorer so you can see it).  You can also have a look at pxecontrol.log to see the extraction process and/or the error occurring.
On some computers you might PXE boot, proceed to see a screen which indicates that the PC is talking with SCCM, followed by a line which indicates a boot ROM called abortpxe has been used.  This indicates one of two things:


This computer has already been built via PXE.
If you want to run this advertisement again, you must go into the console, right click on the computer record and select clear pxe advertisement


There is no advertisement for this machines mac address or SMSBIOS GUID in the database.
This can be confirmed by viewing the smspxe.log.  In this case, you should ensure that
a. The computer record has the correct MAC address
b. The computer record is in a collection which has the task sequence advertised to it
c. The task sequence advertisement is available to PXE boot (a property of the advert)
[b]Software Update issues on reference build[/b]
While creating the reference build, the target machine must not be a member of a domain (and therefore must only be in a workgroup).  Because of this, the machine cannot use AD to lookup SCCM server location details and software updates will fail (after a 20 minute wait).

To work around this, in your reference build TS, navigate to the step setup windows and configmgr, and in the installation properties add  
SMSSLP=<fqdnOfSCCMServer> SMSMP=<fqdnOfSCCMServer> 

Open in new window

This will allow the client to locate the software update point and download the appropriate updates. (Note: this assumes you have installed the Server Locator Point role on your server).

In the case that there are a large number of updates to be downloaded, you may also find that this task fails. This is caused by an issue documented in this TechNet blog entry about error 0x80244010.  Due to this issue, I recommend you create a number of software update tasks (I use 3), each with continue on error checked.  This will get around this issue, but will not cause any significant delay even if this issue does not occur.

The deployment guys have a fantastic blog post on how to handle drivers in this TechNet Driver Management blog entry.

[b]Boot image drivers[/b]
SCCM boot images are customised windows PE 2.x images used to boot the computer and contact the SCCM server. There are a couple of basic rules when working with boot images:


SCCM boot images only require network and local disk access (as they need to grab data from the SCCM server and apply it to the local disk) so these are the only drivers that ever need to be added to a boot image. (adding additional drivers will only bloat the image, slowing down your installs).


SCCM boot images are based on Windows PE 2.x, which is based on Vista.
You must add Vista drivers to your boot images only.  Even if you're deploying on XP, it doesn't matter, the boot environment is completely separate to your final OS.
The way I find out if I need to add additional boot wim drivers is to simply boot any new machines into a OSD TS, boot, press F8 to get a command prompt, then run

Open in new window

If there is no ip address (we don't have NIC drivers and they need to be added), then run
diskpart | list disk

Open in new window

If there are no disks listed, then we need to add mass storage drivers to the boot WIM.

[b]Windows XP 07B stop issues[/b]
If you're building Windows XP or 2003, these operating systems do not allow dynamic injection of mass-storage drivers. So, you have a few options:
Move to Windows 7 -- which after 6 months of betas/RCs and now running RTM - I'm willing to say is brilliant.  ...or...
Change the disk controller mode from AHCI or RAID to IDE in the BIOS (quick, but not recommended for a long term solution).  ...or...
Use the appropriate AHCI mass storage drivers:
a. Import the drivers into SCCM, using categories etc. (see the deployment guys blog post on
    best practices for this)
b.  Add a task to the task sequence: Apply driver package
c.  Select the appropriate driver package
d.  Check the box: Select the mass storage driver within the package......
e.  Select the appropriate driver.
f.  Add a condition via a TS variable <model> or WMI Query (again, covered in the deployment guys post)

[b]Task Sequence Variables[/b]
Task sequence variables are really what give task sequences a bucketload of power, as you can have one TS which accounts for all the variations in your environment.

One of the most common questions we get is:
      How do I know what TS Variables are available?
Well, there is a list in this article:  Operating System Deployment Task Sequence Variables, or you could read the documentation (Toolkit Reference.doc from the MDT 2008 documentation), or search through the script which gathers the variables (ZTIGather.vbs), or dump them all out using another useful script from the deployment guys (See Logging All the Configuration Manager Task Sequence Variables).

The advantage of dumping them all is that the output actually has meaning, so you can see what variable has what value -- as opposed to just looking at a bunch of variables that might not mean much to you without values assigned to them.

In addition to the built in variables, you can add custom variables to computer objects or to entire collections.

[b]SCCM Client Version[/b]
If you are using SCCM 2007 SP1, there is a hotfix, KB955955 available here, which you should apply, as it removes a delay between tasks, which, for long task sequences can significantly reduce build time.  The article also includes instructions on how to implement the hotfix during your bare-metal builds.
Hayes JupeIT Director
Microsoft infrastructure nerd with 20+ years experience. Australian based, but works worldwide.

Comments (8)

Any suggestions on when not everything in your unattend.xml runs?
Luciano PatrĂ£oICT Senior Infraestructure  Engineer  

Great Article!

Keep the good work.


Excellent article.

Thank You :)

IT GuySys Admin/Windows Admin

Does this article still apply to the latest versions of SCCM such as SCCM version 2002?
Hayes JupeIT Director
Distinguished Expert 2021


No - this article was written back in the SCCM 2007 days.
Some of it is still relevant - but there are better ways of doing things now for quite a bit of it.

View More

Have a question about something in this article? You can receive help directly from the article author. Sign up for a free trial to get started.