Installing the Microsoft Internet Information Service BTM extension

This section describes how to install the IIS BTM extension on Windows.

Before you begin

  • Check that the Windows component IIS is installed.

To install the Microsoft Internet Information Service BTM extension

  1. Install the Microsoft Visual C++ 2017 Redistributable Package. If your Windows OS is 32 bit install the vcredist_x86.exe located in the agent distribution directory. If your Windows OS is 64 bit install the vcredist_x64.exe located in the agent distribution directory. If you are running your IIS in 32 bit mode on a 64 bit Windows OS also install vcredist_x86.exe. Note, you might have already done this for other BTM extension types. It only needs to be done once but make sure it was the right version (32 bit or 64 bit).
  2. Deploy the Microsoft IIS BTM runtime toolkit.
  3. Move the jar file to the IIS server and extract it to any folder on the server.

    The BTM IIS binary can be installed as:
    • An ISAPI Filter to monitor responses only. See Installing as an ISAPI filter below. 
    • An ISAPI Extension to monitor requests only. See Installing as an ISAPI extension below.
    • Both an ISAPI filter and ISAPI extension to monitor both requests and responses.

    Additionally, it can be installed in the following locations:
    • A virtual directory
    • A specific web site
    • All web sites

      Note

      Use the same btmiis_extension.dll for both the ISAPI Filter and ISAPI Extension when both are configured.
  4. When you are done with the installation, restart IIS to activate the changes.

Note

If you see an event in the Windows Event Viewer System log with a source of SideBySide when you start IIS or the first http request is received by IIS make sure you have installed the Microsoft Visual C++ 2017 Redistributable Package as outlined in the installation steps.

Installing as an ISAPI filter

  1. Navigate to the required location. This can be a virtual directory, a specific web site or sites.
  2. Select the ISAPI Filters icon.
  3. Click the Add action and enter a name for the filter; btmiis is recommended.
  4. Use the [...] button to browse to locate btmiis_extension.dll.
  5. Click OK.

Installing as an ISAPI extension

  1. Navigate to the required location. This can be a virtual directory, a specific web site or sites.
  2. Select the Handler Mappings icon.
  3. Click Add Wildcard Script Map action.
  4. Use the [...] button to select the btmiis_extension.dll and enter the name for the wildcard script; btmiis is recommended.
  5. Click OK.

Where to go from here

Was this page helpful? Yes No Submitting... Thank you

Comments