How do I configure IIS 6 on Windows Server 2003 to allow the BrowserHawk Reports Web Service to execute?
Under IIS 6 on Windows Server 2003 and later you must explictly mark ISAPI extensions with an "Allowed" status in order for ISAPI extensions and filters to execute.
If you do not, the BH Reports Web Service (BRWS) will not execute and instead return 404 error status codes. This article describes the process for configuring IIS to allow the BRWS to execute.
Perform the following steps on your Windows Server 2003 machine:
Note: If the cyscapeBRWS.dll file tries to download to the browser rather than executing, it means that execute permissions are not set properly.
- On the IIS Manager (MMC).
- Click on the Web Service Extension folder founder under the local computer name on the left-hand side.
- Click on the link that says "Add a new Web service extension..." on the right-hand side. A dialog box titled "New Web Service Extension" will appear. Set these fields as described below.
- Under extension name enter "BrowserHawk Reports Web Service"
- Under "Required files" click the Add button. Browse to the directory where you placed the cyscapebrws.dll file for the virtual web directory you created for the BH Reports Web Service to run from. For example "c:\inetpub\wwwroot\brws\" or "c:\inetpub\wwwroot\mysite\brws\".
NOTE: Do not browse to the \Program Files\cyScape\BrowserHawk directories to select the cyscapebrws.dll from there, as this is not the location where the file will be accessed from when used through the web site (it will be accessed from the virtual web directory you created for it, which resides in a web folder)
- After browsing to the directory mentioned above, select the cyscapebrws.dll file list there.
- Check the Set Extension Status to Allowed check box so that it is allowed.
- Press OK and close the IIS Manager. Your web server will now permit the BRWS ISAPI extension to execute.
If you are using IIS 7 be sure and follow these steps as well.