Microsoft KB Archive/921464

= How to use the Debug Diagnostics 1.0 tool to analyze a memory dump file =

Article ID: 921464

Article Last Modified on 7/6/2006

-

APPLIES TO


 * Microsoft Internet Information Services 6.0

-





INTRODUCTION
This article describes how to use the Debug Diagnostics 1.0 tool to analyze a memory dump file that you created for a Microsoft Internet Information Services (IIS) 6.0 process. After the Debug Diagnostics 1.0 tool finishes analyzing the data in the memory dump file, the tool makes recommendations for how to resolve the issues.

Notes
 * The Debug Diagnostics 1.0 tool is included with the IIS Diagnostics Toolkit.
 * You can use the Debug Diagnostics 1.0 tool to troubleshoot any Microsoft Win32 process.



How to install the Debug Diagnostics 1.0 tool and how to configure the Debug Diagnostics 1.0 tool
To install the Debug Diagnostics 1.0 tool and to configure the Debug Diagnostics 1.0 tool, follow these steps:  Download the Debug Diagnostics 1.0 tool, and then install the Debug Diagnostics 1.0 tool. To do this, visit the following Microsoft Web site:

http://www.iis.net/handlers/895/ItemPermaLink.ashx

 Click Start, click Run, type the path of the Debug Diagnostics 1.0 tool, and then click OK.

Notes  By default, the Debug Diagnostics 1.0 tool is located in the following folder:

C:\Program Files\IIS Resources\DebugDiag

 If the Select Rule Type dialog box appears, click Cancel.  Select the memory dump file that you want to analyze. To do this, follow these steps:  Click Start, click Run, type the path of the Debug Diagnostics 1.0 tool, and then click OK.</li> Click the Advanced Analysis tab, and then click Add Data Files.</li> Click the memory dump file that you want to analyze, and then click Open.</li></ol> </li> Configure the path for the symbol files. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> Click Start, click Run, type the path of the Debug Diagnostics 1.0 tool, and then click OK.</li> On the Tools menu, click Options and Settings.</li> Click the Folders and Search Paths tab, type the following path in the Symbol Search Path for Analysis box, and then click OK:

srv* *http://msdl.microsoft.com/download/symbols

Notes  In this path,  is a placeholder for the folder or for the UNC share where you want to store the downloaded symbol files.</li> By default, the symbol files are stored in the C:\Symcache folder.</li> You cannot browse the http://msdl.microsoft.com/download/symbols Web site. Only debugging tools can access this Web site.</li></ul> </li></ol> </li> Start the analysis. To do this, follow these steps: <ol style="list-style-type: lower-alpha;"> Click Start, click Run, type the path of the Debug Diagnostics 1.0 tool, and then click OK.</li> Click the Advanced Analysis tab.</li> Under Available Analysis Scripts, click the type of analysis that you want.

For example, if you created the memory dump file because a process stopped responding, click Crash/Hang Analyzers. If you created the memory dump file to troubleshoot a memory leak issue, click Memory Pressure Analysis.</li> Under Data Files, click the memory dump file that you selected in step 3.</li> <li>Click Start Analysis.</li></ol> </li></ol>

How to review the report
Review the report that is displayed in Microsoft Internet Explorer. A copy of the report is also stored in the following folder:

C:\Program Files\IIS Resources\DebugDiag\Reports

The report contains the following three sections.

Analysis summary
In this section, the detected issues are classified as errors, as warnings, or as information. This section contains a description of each error. Additionally, this section contains recommendations for how to resolve the issues. The recommendations may include reviewing a Microsoft Knowledge Base article, contacting the application vendor, or contacting Microsoft Product Support Services. This section may also provide information to the developer of the application.

Analysis details
This section provides a detailed analysis of the information in the memory dump file.

Script summary
This section provides a report on the status of the script (Iisanalysis.asp) that is used to analyze the memory dump file. If an error occurs when the script is running, this section reports the error code, the source, the destination, and the lines of code that cause the error.

Keywords: kbhowto KB921464

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.