Find 
Home of the HomepageSearchEngine Umschalten auf Deutsch 
menu

Microsoft IIS support

[ The 'cgi-bin' directory | Allow Web Service Extension | Write and Delete permissions for the installation directory ]

If you want to use HomepageSearchEngine with IIS (Internet Information Services) version 6.0 (under Windows 2003), you should take care of the following configuration notes, to avoid problems. For use with IIS 6.0 a HomepageSearchEngine version of at least 3.5 is required.

For older IIS versions (5.0 / Windows 2000 or 4.0 / Windows NT), please refer to the IIS 4-5 support page instead.


The 'cgi-bin' directory
Before creating HomepageSearchEngine's installation directory within a directory reserved to execute CGI programs, make sure this CGI directory exists with the proper IIS permissions. We assume that there has been created a CGI directory called cgi-bin under the WWW Root directory, resulting in a path like 'E:\Inetpub\wwwroot\cgi-bin'.

After opening the IIS Manager by selecting "Start / Programs / Administrative Tools / Internet Information Services (IIS) Manager", select the 'cgi-bin' directory under "Default Web Site" in the left frame of the IIS Manager and click the "Properties" icon. In the "Directory" tab, make sure that all "Read", "Write" and "Directory browsing" permissions are disabled and that the Execute permissions are set to "Scripts and Executables". The window should look like this:

cgi-bin Properties - IIS Manager

Once the cgi-bin directory has these IIS permissions, the hse directory containing the HomepageSearchEngine.exe (and p2xlib.dll) file (the installation directory) can be copied into it, which should then have the same permissions shown by the IIS Manager.

Allow Web Service Extension
In the left frame of the IIS Manager, select "Web Service Extensions". In the right frame, click "Add a new Web service extension...". In the "New Web Service Extension" window, write "HomepageSearchEngine" into the "Extension name:" field and add the path to the HomepageSearchEngine.exe file into the "Required files:" field. Enable the "Set extension status to Allowed" checkbox. The window should look like this:

New Web Service Extension

Finally, click "OK". The IIS Manager window should now look like this:

IIS Manager

Write and Delete permissions for the installation directory
HomepageSearchEngine usually needs a directory within its installation directory to store temporary files inside. That directory (called tmp) will be created automatically if it does not exist. Thus, the user HomepageSearchEngine is running as should have permissions to write and delete within the installation directory (cgi-bin/hse). Under IIS 6, CGI programs typically run as the "Internet Guest Account" user.

Right-click the hse directory in Windows Explorer and select "Properties". In the "Security" tab, select the "Internet Guest Account" and enable the "Write" checkbox under the "Allow" column. Then, click the "Advanced" button. In the "Advanced Security Settings for hse" window, select the Permission entry "Allow / Internet Guest Account / Write", click the "Edit..." button and enable the "Delete" checkbox under the "Allow" column. The resulting windows should look like this:

Permission Entry for hse

Windows Explorer - hse Properties
on top  

HomepageSearchEngine.com © 1999-2008, ANET.at

100% valid XHTML 1.0