Tracing with ESB Toolkit 2.2

Thanks to Tomasso Groenendijk for figuring this one out and sharing.

As with previous versions of the ESB Toolkit there is a minor change required to get tracing working. The switch name no longer has the version number appended to it. So instead of “BizTalkESBToolkit20” or “BizTalkESBToolkit21” as in previous versions, it is now “BizTalkESBToolkit”.

This should remain constant going forward removing the need to guess what the switch name is on each release!

Similar to ESB Toolkit 2.1, the full list of steps are:

1. In Notepad openC:\Windows\Microsoft.NET\Framework\v4.0.30319\CONFIG\machine.config for 32-bit
   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\CONFIG\machine.config for 64-bit
2. Locate the line with the closing configSections tag.
3. Under that line paste the following section:

   <system.diagnostics>
         <switches>
             <add name="BizTalkESBToolkit" value="4"/>
         </switches>
   </system.diagnostics>

4. Save and close machine.config.
5. Start the DebugView program (Download)
6. In DebugView, on the Capture menu, click Capture Global Win32 to make sure that it is checked.
7. In the BizTalk Server Administration console, restart the BizTalkServerApplication host instance.

Tracing with ESB Toolkit 2.1

There are two minor changes that are worth noting when turning tracing for ESB Toolkit 2.1 on.

1. In Notepad open
   
   C:\Windows\Microsoft.NET\Framework\v4.0.30319\CONFIG\machine.config for 32-bit
   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\CONFIG\machine.config for 64-bit

2. Locate the line with the closing configSections tag.
3. Under that line paste the following section:

   <system.diagnostics>
         <switches>
             <add name="BizTalkESBToolkit21" value="4"/>
         </switches>
   </system.diagnostics>

4. Save and close machine.config.
5. Start the DebugView program (Download)
6. In DebugView, on the Capture menu, click Capture Global Win32 to make sure that it is checked.
7. In the BizTalk Server Administration console, restart the BizTalkServerApplication host instance.

Original steps documented for ESB Toolkit 2.0 by Nick Hauenstein.

Another point worth noting is that there are less traces output by ESB Toolkit 2.1 in comparison with ESB Toolkit 2.0.