Configuring the Microsoft Internet Information Services 7.

0 Web Server
First of all make sure that ISAPI Filters and (not sure) ISAPI Extensions IIS Role Services are installed, reboot may be needed after the installation.

To configure the Microsoft Internet Information Services (IIS) 7.0 Web server on Windows: 1. Create a virtual directory named jakarta that points to the IIS scripts directory, as follows: a. b. c. Select Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager. Create a new (or select an existing) Web site under your IIS to integrate with the PPM application server. Create a new (or select an existing) directory in your file system in which to store the integration-related files. Lets call this directory <ISAPI_REDIRECTOR_HOME> Copy the workers.properties file, uriworkermap.properties file and <ITG_Home>/integration/webserverplugins/iis/windows/x86-32/isapi_redirect.dll file to the <ISAPI_REDIRECTOR_HOME> directory you created (or selected) in step c. Right-click the Web site you created (or selected) in step b. Select Add Virtual Directory.

d.

e. f.

g.

On the first Add Virtual Directory window enter Alias name (e. g. Jakarta), <ISAPI_REDIRECTOR_HOME> directory path and click OK

An example of this directory is c:\inetpub\scripts. Depending on the IIS root directory configuration, the drive and directory may vary. This directory must have run permission. 2. Configure a workers.properties file and uriworkermap.properties file. 3. To configure IIS to load isapi_redirect.dll as a filter: a. To define registry values for IIS with Apache Jakarta Tomcat Connector (JK): i. Add the following registry key: HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0 ii. Add a string value with the name extension_uri and a value /jakarta/isapi_redirect.dll. iii. Add a string value with the name worker_file a value which is the full path to the workers.properties file, i.e. <ISAPI_REDIRECTOR_HOME>\workers.properties (for example, c:\inetpub\scripts\workers.properties) iv. Add a string value with the name log_level and the value ERROR (other options include DEBUG and INFO for more verbose logging). v. Add a string value with the name log_file and a value pointing to where you want your log file to be, including the log file name (For example, c:\ITG\isapi.log)

vi. Add a string value with the name worker_mount_file and a value which is the full path to your uriworkermap.properties file, i.e. <ISAPI_REDIRECTOR_HOME>\uriworkermap.properties (for example, c:\inetpub\scripts\ uriworkermap.properties) vii. Due to a known bug in JK 1.2.18 (http://issues.apache.org/bugzilla/show_bug.cgi?id=40384) the following setting is required: Create empty file rewrites.properties in <ISAPI_REDIRECTOR_HOME> directory. Add a string value with the name rewrite_rule_file and a value which is the full path to newly created rewrites.properties file, i.e. <ISAPI_REDIRECTOR_HOME>\rewrites.properties (for example, c:\inetpub\scripts\rewrites.properties)

The following screenshot illustrates a properly configured registry:

b.

Select Start > Control Panel > Administrative Tools > Internet Information Services Manager. For IIS 7.0, perform the following steps.

c.

Click the Web site name, and then open the ISAPI Filters from the center panel. ISAPI Filters window opens.

e. f.

Select Add at the Actions list (from the right). Add ISAPI Filter window opens. Enter ISAPI Filter name (e. g. Jakarta) and path to the isapi_redirect.dll. Click OK.

Your filter appears at the ISAPI Filters list. 5. Allow Tomcats redirector DLL in Web service extensions, as follows: a. Go to web server level and click ISAPI and CGI Restrictions.

ISAPI and CGI Restrictions window appears. b. At ISAPI and CGI Restrictions window select Add from the actions menu at the right. Add ISAPI or CGI Restriction window appears. c. At Add ISAPI or CGI Restriction window type the extension description (for example, Jakarta-Tomcat) and path to isapi_redirect.dll. Check Allow extension path to execute checkbox. Click OK.

d. Select your restriction at ISAPI and CGI Restrictions list and click Allow at Actions list.

6.

To allow execution of ISAPI filter:

a. Go to the Site Level and double click to Handler Mappings.

Handler Mappings window appears. b. Right click on ISAPI-dll item and select Edit Feature Permissions. Edit Feature Permissions window appears. c. At the Edit Feature Permissions window check all checkboxes. Click OK.

7.

Restart IIS service. Please note that restarting the website is not enough. You have to restart World Wide Web Publishing Service from the Services management console. Start the PPM Server(s).

8.