Microsoft KB Archive/924747

= How to use the Enterprise Single Sign-On Trace utility for Host Integration Server systems and for BizTalk Server systems =

Article ID: 924747

Article Last Modified on 12/4/2007

-

APPLIES TO


 * Microsoft Host Integration Server 2006
 * Microsoft BizTalk Adapter for Host Systems
 * Microsoft Host Integration Server 2004 Enterprise Edition
 * Microsoft Host Integration Server 2004 Standard Edition
 * Microsoft BizTalk Server 2006 Developer Edition
 * Microsoft BizTalk Server 2006 Enterprise Edition
 * Microsoft BizTalk Server 2006 Standard Edition
 * Microsoft BizTalk Server 2004 Developer Edition
 * Microsoft BizTalk Server 2004 Enterprise Edition
 * Microsoft BizTalk Server 2004 Partner Edition
 * Microsoft BizTalk Server 2004 Standard Edition

-



INTRODUCTION
This article describes how to install and run the Enterprise Single Sign-On Trace utility. You can use the Enterprise Single Sign-On trace utility to troubleshoot issues with Microsoft Host Integration Server systems and Microsoft BizTalk Server systems.



MORE INFORMATION
The Enterprise Single Sign-On Trace utility uses Event Tracing for Windows (ETW). Therefore, before you can run the Enterprise Single Sign-On Trace utility, you must install and enable the ETW trace tools.

Step 1: Install the ETW trace tools
To install the ETW trace tools, follow these steps:  Download the Microsoft Platform SDK. To do this, visit the following Microsoft Web site:

http://go.microsoft.com/fwlink/?LinkId=21975

 To start the Platform SDK Web installation program, click the appropriate link for the system:  For an x86-based system, click Download for the PSDK-x86.exe file. For an x64-based system, click Download for the PSDK-amd64.exe file.  Click Run. When the Setup Wizard window appears, click Next.</li> If you agree to the software license terms, click I Agree, and then click Next.</li> Click Custom, and then click Next.</li> Select an installation location, and then click Next.</li> In the Custom Installation window, click to clear all the available features.</li> Expand Microsoft Windows Core SDK, and then expand Tools.</li> Select the appropriate option for the system:  For an x86-based system, click Tools (Intel 64-bit), and then click Will be installed on local hard drive.

Note The Tools (Intel 64-bit) option also installs the 32-bit tools. Therefore, select this option when you are running an x86-based system.</li> For an x64-based system, click Tools (AMD 64-bit), and then click Will be installed on local hard drive.</li></ul> </li> To start the installation, click Next two times.</li> After the installation is complete, click Finish.</li> Locate the :\ \bin folder, and then copy the Tracelog.exe file from this folder to the Enterprise Single Sign-On installation folder.

Notes  By default, the Enterprise Single Sign-On folder is located in the following path:



</li> The Enterprise Single Sign-On installation folder also contains the Trace.cmd file. You must use this file in the next step to enable the ETW trace tools.</li></ul> </li></ol>

Step 2: Enable the ETW trace tools
To enable the ETW trace tools, follow these steps: <ol> Click Start, click Run, type cmd, and then click OK.</li> <li>Change the current folder to the folder in which Enterprise Single Sign-On is installed. By default, the Enterprise Single Sign-On folder is located in the following path:



</li> <li>Type the following command, and then press ENTER:

trace -tools &quot; &quot;

Notes <ul> <li> represents the path in which the ETW trace tools are located. By default, the ETW trace tools are located in the following path:

C:\Program Files\Microsoft Platform SDK\Bin

</li> <li>You must enclose the path of the ETW trace tools in quotation marks. For example, type the following command:

trace -tools &quot;C:\Program Files\Microsoft Platform SDK\Bin&quot;

</li> <li>The -tools switch indicates the location of the Tracelog.exe file to the Trace.cmd file.</li></ul> </li></ol>

Step 3: Run the Enterprise Single Sign-On Trace utility
To run the Enterprise Single Sign-On Trace utility, follow these steps: <ol> <li>Click Start, click Run, type cmd, and then click OK.</li> <li>To start the trace, type the following command, and then press ENTER:

trace -start -

Note  represents the trace level. The valid trace levels are low, medium, high, and all. The default level is high.</li> <li>Reproduce the scenario that you want to trace.</li> <li>To stop the trace, type the following command, and then press ENTER:

trace -stop

Note After you stop the trace, a binary file that is named ESSO.bin is generated in the folder in which Enterprise Single Sign-On is installed. You can send this file to Microsoft Customer Support Services for additional analysis.</li></ol>

<div class="references_section">