Microsoft KB Archive/924747

From BetaArchive Wiki

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:

  1. Download the Microsoft Platform SDK. To do this, visit the following Microsoft Web site:
  2. 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.
  3. Click Run.
  4. When the Setup Wizard window appears, click Next.
  5. If you agree to the software license terms, click I Agree, and then click Next.
  6. Click Custom, and then click Next.
  7. Select an installation location, and then click Next.
  8. In the Custom Installation window, click to clear all the available features.
  9. Expand Microsoft Windows Core SDK, and then expand Tools.
  10. 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.
  11. To start the installation, click Next two times.
  12. After the installation is complete, click Finish.
  13. 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.

Step 2: Enable the ETW trace tools

To enable the ETW trace tools, follow these steps:

  1. Click Start, click Run, type cmd, and then click OK.
  2. 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

  3. 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:

  1. Click Start, click Run, type cmd, and then click OK.
  2. To start the trace, type the following command, and then press ENTER:

    trace -start -Level

    Note Level represents the trace level. The valid trace levels are low, medium, high, and all. The default level is high.
  3. Reproduce the scenario that you want to trace.
  4. 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.


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