Citrix states in their article: CTX109097

Document ID: CTX109097, Created on: Apr 27, 2006, Updated: Apr 27, 2006

Products: Citrix MetaFrame 1.8 for Microsoft NT 4.0 Server Terminal Server Edition, Citrix MetaFrame 1.8 for Microsoft Windows 2000, Citrix MetaFrame XP 1.0 for Microsoft NT 4.0 Server Terminal Server Edition, Citrix MetaFrame XP 1.0 for Microsoft Windows 2000, Citrix MetaFrame XP 1.0 for Microsoft Windows 2003, Citrix MetaFrame Presentation Server 3.0 for Microsoft Windows 2000, Citrix MetaFrame Presentation Server 3.0 for Microsoft Windows 2003, Citrix Presentation Server 4.0 for Microsoft Windows 2000, Citrix Presentation Server 4.0 for Microsoft Windows 2003

Summary

This document describes how to enable Full Page Heap when creating dump files for Citrix Technical Support.

Requirements

• Microsoft Windows Server 2000 or 2003

• Microsoft Windows 2000 or XP

• Microsoft Windows Debugging Tools for Windows

Background

Citrix Technical Support will request a dump of a particular process for a variety of reasons, usually when the process is underperforming or behaving erratically.

Dump files can be generated with a number of tools such as Dr.Watson, NTSD, ADPlus, and WinDBG (all Microsoft tools). However, sometimes Support will request that the dumps be created with Full Page Heap enabled.

Enabling Full Page Heap causes a process to crash exactly at the point of failure, thereby making the failure much easier to debug. The resulting dump files should then clearly pinpoint the cause of a particular problem and allow for faster problem resolution.

Note: Enabling Full Page Heap can have a temporary impact on system performance.

Procedure

Full Page Heap can be enabled by following CTX104633 – How to Enable Full Page Heap for the IMA Service and verified after the dump is created by following CTX105955 – How to Check In a User Dump That Full Page Heap Was Enabled.

Full Page Heap can also be enabled by using the Advanced Configuration options of the Microsoft Debug Diagnostics Tool (a subset of the Microsoft IIS Diagnostics Toolkit).

More Information

Citrix

• CTX104633 – How to Enable Full Page Heap for the IMA Service (valid for any executable, not just the IMA service)

• CTX105955 – How to Check In a User Dump That Full Page Heap Was Enabled

• CTX108889 – Using the Microsoft Debug Diagnostics Tool to Create Dump Files

Microsoft

• 286470 – How to use Pageheap.exe in Windows XP and Windows 2000 (valid also for Windows 2003)

• 300966 – How to debug heap corruption issues in Internet Information Services (IIS)

Microsoft Debugging Tools For Windows

IIS Crash/Hang Agent & IIS Dump v1.1 (primarily an IIS-related tool, but gflags.exe and pageheap.exe are included)