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:
- 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.
- If you agree to the software license terms, click I Agree, and then click Next.
- Click Custom, and then click Next.
- Select an installation location, and then click Next.
- In the Custom Installation window, click to clear all the available features.
- Expand Microsoft Windows Core SDK, and then expand Tools.
- 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. - For an x64-based system, click Tools (AMD 64-bit), and then click Will be installed on local hard drive.
- For an x86-based system, click Tools (Intel 64-bit), and then click Will be installed on local hard drive.
- To start the installation, click Next two times.
- After the installation is complete, click Finish.
- Locate the
Drive
:\Platform_SDK_Installation_Location
\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:
Drive
:\Program Files\Common Files\Enterprise Single Sign-On - 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.
- By default, the Enterprise Single Sign-On folder is located in the following path:
Step 2: Enable the ETW trace tools
To enable the ETW trace tools, follow these steps:
- Click Start, click Run, type cmd, and then click OK.
- 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:
Drive
:\Program Files\Common Files\Enterprise Single Sign-On - Type the following command, and then press ENTER:
trace -tools "
ETWTraceToolsPath
"Notes
ETWTraceToolsPath
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
- You must enclose the path of the ETW trace tools in quotation marks. For example, type the following command:
trace -tools "C:\Program Files\Microsoft Platform SDK\Bin"
- The -tools switch indicates the location of the Tracelog.exe file to the Trace.cmd file.
Step 3: Run the Enterprise Single Sign-On Trace utility
To run the Enterprise Single Sign-On Trace utility, follow these steps:
- Click Start, click Run, type cmd, and then click OK.
- To start the trace, type the following command, and then press ENTER:
trace -start -
Level
Level
represents the trace level. The valid trace levels are low, medium, high, and all. The default level is high. - Reproduce the scenario that you want to trace.
- To stop the trace, type the following command, and then press ENTER:
trace -stop
REFERENCES
For more information about the ETW trace tools, visit the following Microsoft Developer Network (MSDN) Web site:
Additional query words: SSO
Keywords: kbhowto kbinfo KB924747