Configuring the Microsoft Internet Information Services 7.0 Web Server

echinoidqueenServers

Dec 4, 2013 (3 years and 8 months ago)

99 views

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. Select Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.
b. Create a new (or select an existing) Web site under your IIS to integrate with the PPM application server.
c. Create a new (or select an existing) directory in your file system in which to store the integration-related
files. Let’s call this directory <ISAPI_REDIRECTOR_HOME>
d. 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.
e. Right-click the Web site you created (or selected) in step b.
f. Select Add Virtual Directory.
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. Select Add… at the Actions list (from the right). Add ISAPI Filter window opens.
f. 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 Tomcat’s 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.
8. Start the PPM Server(s).