Installing and Configuring WinDbg (Windows Debug Tools)‏

These steps outline how to install and configure WinDbg correctly to analyse Windows Dump files and IIS Debug Diagnostics files amongst others.

Setup Guide:

1. Install WinDbg

- Navigate to Debugging tools for Windows on the Microsoft site and download the Windows Driver Kit (WDK) file from here. (Please bear in mind that as at the time of this post, Microsoft in their infinite wisdom :) have merged the standalone version of the tool as part of the Windows Drivers Kit). Click here for direct link to download.

- Run the downloaded MSI application package -> click Next (Bear in mind that if you were debugging a 64-bit version of Windows you will require the 64-bit version of the debugging tools and install on a 64-bit version of Windows)

- On End-User License Agreement page -> Select I Agree -> click Next

- On the Select an Installation Type -> For the purpose of this post, I’ll select the Complete package -> click Next

- On Ready to Install page -> click Install

- Click Finish when installation is completed

2. Configure the Symbols

- Load up the debugging tool by clicking on Start -> All Programs -> Debugging Tools for Windows -> Windbg

- Click File -> Symbol File Path… -> enter the following text into the window “SRV*c:\WINDOWS\symbols*http://msdl.microsoft.com/download/symbols” without the quote (“”)
(Note: The path at the front can be changed i.e. c:\windows\symbols, this is just the store for the file that need to be downloaded) -> click OK

3. Analyzing Dump Files

I am not going to analyze any dump files in this post but my aim here is to ease your search and provide you with links to very useful sites that have already documented steps needed when debugging a dump file. All dump files varies depending on the type of crash, this includes Memory Dump, IIS Application Pool Crash Dump,

- Basics of Analyzing a Crash dump

- Checking a dump file for WCF throttles

- Process Memory Dump

- Analyze “Deadlocked Schedulers” Dump

- Troubleshoot OutOfMemoryExceptions

Getting started with windbg – part I
Getting started with windbg – part II

- Debugging tutorials in codeproject

Debug Tutorial Part 1: Beginning Debugging Using CDB and NTSD
Debug Tutorial Part 2: The Stack
Debug Tutorial Part 3: The Heap
Debug Tutorial Part 4: Writing WINDBG Extensions
Debug Tutorial Part 5: Handle Leaks
Debug Tutorial Part 6: Navigating The Kernel Debugger
Debug Tutorial Part 7: Locks and Synchronization Objects

4. Useful WinDbg commands

- windbg.info

- Crash Dump Analysis Checklist

  • http://www.xenlinux.com Waqar Ahmed

    Thank you very much for this. Very useful

    • Sysadmin

      Thanks for your comment

  • http://oixypea1.com/oxovyr/5.html Pharmk551

    Very nice site!

    • Sysadmin

      Thanks for visiting

  • tmack

    Hi, I selected the option to include redistributable files but they are nowhere to be found on my drive.

    I have Win 7 x64 so the x64 bits were installed; will these tools debug x86 apps?

    Thanks

  • wolf5370

    @tmack Hi – suggest downloading the standalone Windows 8.1 Debugging Tools (this works on Win 7 x64!) – deselect everything except for Debugging tool. It will then be under C:Program Files (x86)Windows Kits8.1Debuggersx64 (for 64 bit WinDbg – or x86 directory for 32bit)