Home » Support » Integration » Microsoft IIS

Integrating SearchBlox Server with Microsoft IIS

To configure Microsoft IIS for use with SearchBlox Server for Windows:
  1. On the machine where IIS is deployed, download the ISAPI Redirect installer from the Apache website. When downloading, choose the version of Windows that IIS is running on (either win32 or win64), and then choose the latest available jk version. The file to download is called isapi_redirect.msi.
  2. Run the installer by executing the downloaded file. By default the files are installed into the "C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector" directory.
  3. In the "C:\Program Files\Apache Software Foundation\Jakarta Isapi Redirector\conf" directory you will need to modify the uriworkermap.properties file. The uriworkermap.properties tells IIS what requests to proxy to SearchBlox Server. To edit this file, please follow these steps:

    - Edit the uriworkermap.properties and comment out (by adding the '#' character at the beginning of each line) all the mappings except for /jkmanager=jkstatus.

    - Add mapping for SearchBlox by adding the line /searchblox/*=wlb at the end of the file. The last lines of the file should look like:

    /jkmanager=jkstatus
    /searchblox/*=wlb
  4. You will need to add the ISAPI Filter.

    - Open the Internet Information Services Console.

    - Right-click on Default Web Site (or the Web Site that should be responsible for proxying requests to SearchBlox), and click on Properties

    - Click on the ISAPI Filters tab

    - Check if there is a Filter that points to the isapi_redirect.dll file and that it is in the right location. If not, click on Add and create one. Enter searchblox as the Filter Name and then enter or browse the location of the isapi_redirect.dll file for the executable.

    - Click on Apply and then OK.
  5. You will need to restart IIS. The best way to ensure that IIS is restarted and reads the configuration files you have modified is to navigate to Control Panel, then to Administrative Tools and open Services. Find a service with name "World Wide Web Publishing", right click on it and choose "Stop". When the service stops, restarted by right-clicking and choosing "Start".
  6. Start the SearchBlox Server
  7. Open a browser and enter the url http://localhost/searchblox/. This request should get a response from the SearchBlox Server.