Share this page

# Configure the Microsoft Internet Information Services 7.0 Web Server on a Windows Server 2008 System

Note: To enable Microsoft Internet Information Services with PPM version 9.50, make sure to select Allowing double escaping as described in step 12 of the configuration process.

The Tomcat redirector plug-in DLL, `isapi_redirect.dll,` does not work under 64-bit mode on Windows 2008 with IIS 7.0. To successfully configure IIS 7.0 on a Windows 2008 system, you must configure the plug-in to work in 32-bit mode.

Note: The 64-bit `isapi_redirect`.`dll` file is for Windows 2003 64-bit.

To configure the Tomcat redirector plug-in DLL to run in 32-bit mode on a Windows Server 2008 system (64-bit machine):

1. Stop the IIS 7.0 Web Server.

2. Open Server Manager on the Microsoft IIS Web server host and make sure that the ISAPI Filters and ISAPI Extensions role services are installed.

   Note: If you must install the ISAPI Filters and ISAPI Extensions, make sure that you restart after you install these services.

3. Start the IIS Manager.

4. In the Advanced Settings section for the Default Application Pools, set Enable 32 bit Application to True.

5. Make sure that you configure the Windows registry for the Tomcat connector (isapi_redirect) as follows:

   For a 32-bit systems:

       HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software

       Foundation\Jakarta Isapi Redirector\1.0

   For 64-bit systems:

       HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software

       Foundation\Jakarta Isapi Redirector\1.0  (for 64bit systems)

6. Create a virtual directory named `jakarta` that points to the IIS scripts directory, as follows:

   1. Select Start > Control Panel > Administrative Tools > Internet Information Services (IIS) Manager.

   2. Under your IIS Web server, create a new (or identify an existing) Web site to integrate with the PPM Server.

   3. In your file system, create a new (or select an existing) directory in which to store integration-related files. In this procedure, this directory is referred to as `<`ISAPI_REDIRECTOR_HOME`>.`

      Caution: The `<ISAPI_REDIRECTOR_HOME>` directory must have run permission.
      If you choose to use the Windows Registry instead of using `isapi_redirect.properties,` then you must use the branch Wow6432Node for running IIS 7.0 on Windows 2008.

   4. Copy the `workers.properties` file, `uriworkermap.properties` file and `<PPM_Home>/integration/webserverplugins/iis/windows/x86-32/isapi_redirect.dll` file to the `<ISAPI_REDIRECTOR_HOME>` directory you created (or selected) in step c.

   5. Right-click the Web site you created (or identified) in step b, and then select Add Virtual Directory from the shortcut menu.

   6. In the first Add Virtual Directory window, do the following:

   1. In the Alias box, type the alias name (for example, `Jakarta`).

   2. Use the Physical path multiselect to navigate to and select the `<ISAPI_REDIRECTOR_HOME>` directory path.

      Note: An example of this directory is `c:\inetpub\scripts.` The drive and directory depend on the IIS root directory configuration. This directory must have run permission.

7. If you are using NTLM for user authentication, then do the following:

   1. Start the Internet Information Services (IIS) Manager and access the Error Pages feature.

   2. Right-click error 500, and then select Edit Feature Settings from the shortcut menu.

   3. Set Error Responses to Detailed errors.

8. Configure both a `workers.properties` file and a `uriworkermap.properties` file.

9. Configure IIS to load `isapi_redirect.dll` as a filter, as follows:

   1. To define registry values for IIS with Apache Jakarta Tomcat Connector (JK):

   1. Add the following registry key:

          HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0

      Add a string named `extension_uri` and set its value to `/jakarta/isapi_redirect.dll.`

   2. Add a string named `worker_file` and set its value to the full directory path for the `workers.properties` file. That is, `<ISAPI_REDIRECTOR_HOME>`\`workers.properties.`

   Example:

   `C:\inetpub\scripts\workers.properties`

   3. Add a string with the name `log_level` and set its value to `ERROR.` (For more verbose logging, options include `DEBUG` and `INFO.`)

   4. Add a string with the name `log_file` and set its value to the directory in which you want to save your log file. Include the log file name in the directory path (for example, `C:\PPM\isapi.log`).

   5. Add a string named `worker_mount_file` and set its value to the full directory path for the `uriworkermap.properties` file. That is, `<ISAPI_REDIRECTOR_HOME>`\`uriworkermap.properties.`

      Example:

      `C:\inetpub\scripts\uriworkermap.properties`

   6. Create a file named `rewrites.properties` in the `<`ISAPI_REDIRECTOR_HOME`>` directory

   7. Add a string named `rewrite_rule_file` to the `rewrites.properties` file and set its value to the full directory path for the new `rewrites.properties` file. That is, `<ISAPI_REDIRECTOR_HOME>\rewrites.properties.`

      Example:

      `C:\inetpub\scripts\rewrites.properties`

   2. Open Internet Information Services (IIS) Manager, and then do the following:

   1. Select the name of the Web site you created (or identified) in Configure the Microsoft Internet Information Services 7.5 Web Server on a Windows Server 2008 System, and then, in the center pane, double-click ISAPI Filters.

   2. In the Actions pane, click Add.

      The Add ISAPI Filter dialog box opens.

   3. In the Filter name box, type a name for the ISAPI filter.

   4. In the Executable box, click the ellipsis button (...), and then navigate to and select the folder that contains the `isapi_redirect.dll` file.

      The ISAPI Filters list displays the filter name.

10. Enable the Tomcat redirector DLL in Web service extensions, as follows:

    1. From the Connections pane of Internet Information Services (IIS) Manager, select the Web server name.

    2. In Features View, double-click ISAPI and CGI Restrictions.

       The ISAPI and CGI Restrictions window opens.

    3. In the Actions pane, click Add.

       The Add ISAPI or CGI Restriction dialog box opens.

    4. Do the following:

    1. In the ISAPI or CGI path text box, provide the full directory path for the `isapi_redirect.dll` file.

    2. In the Description text box, type a short description of the restriction.

    3. Select the Allow extension path to execute check box.

    5. In the ISAPI and CGI Restrictions list, select the restriction you added.

    6. In the Actions pane, click Allow.

11. Enable execution of ISAPI filter, as follows:

    1. From the Connections pane of Internet Information Services (IIS) Manager, select the Web site (see Configure the Microsoft Internet Information Services 7.5 Web Server on a Windows Server 2008 System).

    2. In Features View, double-click Handler Mappings.

    The Handler Mappings window opens.

    3. Right-click the ISAPI DLL item, and then select Edit Feature Permissions from the shortcut menu.

       The Edit Feature Permissions window opens.

    4. Select the Read,Script, and Execute check boxes.

12. Check the Allow double escaping setting is correct by following these steps:

    1. Open Internet Information Services (IIS) Manager.
    2. Select the name of the Web site you created (or identified) in step b pf step 6 . And then, in the center pane, double-click Request filtering.

    3. Right-click in the center pane and select Edit Feature Settings from the menu displayed.

       The Edit Request Filtering Settings window is displayed.

    4. Under General, select the Allow double escaping checkbox, as shown in the following figure.

    5. Click OK.

13. Restart the IIS service. (Restarting the Web site is not enough. You must restart World Wide Web Publishing Service from the Services management console.)

    Note: After you restart the IIS service, the ISAPI filter does not load immediately. The IIS service may require a few minutes to establish a connection with OpenText PPM. Before the connection is established, your browser may display the error message "HTTP Error 404 - File or directory not found. Internet Information Services (IIS)".

14. Start the PPM Server(s).

    Caution: If your OpenText PPM instance includes multiple nodes in a cluster configuration, you must start these nodes one at a time. Make sure that you wait until each node is fully started before you start the next node.

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: