在 BizTalk Server 中安装和使用 BizTalk 适配器跟踪实用工具

本分步指南介绍了如何安装 Microsoft BizTalk 适配器跟踪实用程序。 此外,还讨论了如何运行 BizTalk 适配器跟踪实用工具以及如何分析生成的跟踪文件。

原始产品版本:  BizTalk Server 2009
原始 KB 数:  835451

安装 BizTalk 适配器跟踪实用程序

若要在 Windows Server 2008 上安装 BizTalk 适配器跟踪实用程序,请按照以下步骤操作:

  1. 下载 Tracelog.exe 文件,并安装适用于 Windows Vista 的 Microsoft Windows 软件开发工具包(SDK)更新。

    备注

    Windows SDK for Windows Server 2008 和 Microsoft .NET Framework 3.5 中不包含 Tracelog.exe 文件。 因此,在 Windows Server 2008 上安装 Windows Vista SDK。

    有关详细信息,请参阅适用于 Windows Server 2008 和 .Net Framework 3.5 发行说明的 Windows 软件开发工具包(SDK)

  2. 当出现 "安装选项" 窗口时,展开 "开发工具",然后展开 " Windows 开发工具"。 然后选中 " Win32 开发工具" 复选框。

  3. 清除其他复选框,然后继续安装。

  4. 找到以下文件夹,然后将 Tracelog.exe 文件复制到 BizTalk Server 安装文件夹中:
    Drive: \MicrosoftSDKInstallationFolder\Bin。

默认情况下,Tracelog.exe 文件位于 C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin 文件夹中。 BizTalk Server 安装文件夹还包含 Trace .cmd 文件。

若要在 Windows Server 2003 上安装 BizTalk 适配器跟踪实用程序,请按照以下步骤操作:

  1. 下载 Tracelog.exe 文件,并安装 Windows Server 2003 R2 Platform SDK。

  2. 出现 "选择安装类型" 窗口时,选择 "自定义"。

  3. 在 "自定义安装" 对话框中,展开 " MICROSOFT Windows Core SDK",然后展开 "工具"。

  4. 选择 "工具(Intel 64-bit)",然后选择 "将安装在本地硬盘上"。

  5. 选择会在任何其他内容上可用,然后继续安装。

  6. 找到 " Drive: \MicrosoftPlatformSDKInstallationFolder\Bin" 文件夹,然后将 Tracelog.exe 文件复制到 BizTalk Server 安装文件夹中。

    默认情况下,Tracelog.exe 文件位于 C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\bin 文件夹中。 BizTalk Server 安装文件夹还包含 Trace .cmd 文件。

启用 BizTalk 适配器跟踪实用程序

若要启用 BizTalk 适配器跟踪实用工具,请按照下列步骤操作:

  1. 在命令提示符处,将当前目录更改为安装 BizTalk Server 的目录。 默认情况下,BizTalk Server 安装在 Program Files\Microsoft BizTalk Server 200x directory 中。

  2. 输入以下命令:

    trace -tools "Path of the BizTalk Adapter Trace Utility"
    

默认情况下,在 Windows Server 2003 中,BizTalk 适配器跟踪实用程序位于以下目录中:
C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin。

默认情况下,在 Windows Server 2008 中,BizTalk 适配器跟踪实用程序位于以下目录中:
C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin。

必须用引号将 BizTalk 适配器跟踪实用工具的路径引起来。

例如,在 Windows Server 2003 上输入以下命令:

trace -tools "C:\Program Files\Microsoft Platform SDK for Windows Server 2003 R2\Bin"

在 Windows Server 2008 中,输入以下命令:

trace -tools "C:\Program Files\Microsoft SDKs\Windows\v6.0\Bin"

-tools开关指示 Tracelog.exe 文件到Trace .cmd文件的位置。

运行 BizTalk 适配器跟踪实用工具

若要在某个方案上运行 BizTalk 适配器跟踪实用工具,请按照以下步骤操作:

  1. 在命令提示符处,输入以下命令:

    trace -start -all
    
  2. 重现要跟踪的方案。

  3. 在命令提示符处,输入以下命令:

    trace -stop
    

停止跟踪后,名为 BtsTrace 的 BizTalk Server 2006 和更高版本的二进制文件将在安装了 BizTalk Server 的文件夹中生成。 在 BizTalk Server 2004 中,将在安装了 BizTalk Server 的文件夹中生成名为 Bts2004 的二进制文件。

您可以将 BizTalk Server trace bin 文件发送给 Microsoft 客户支持服务进行分析。