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.

4. Copy the following files to the <ISAPI_REDIRECTOR_HOME> directory you created (or selected) in step c of step 1:

   • The workers.properties and uriworkermap.properties files (located in the <PPM_Home>\integration\webserverplugins\configuration directory

   • The isapi_redirect.dll file under the <PPM_Home>/integration/webserverplugins/iis/windows/x86-32/ directory (for 32-bite), or

     the <PPM_Home>/integration/webserverplugins/iis/windows/x86-64/ directory (for 64-bite)

     For PPM 9.61 and later versions, use the isapi_redirect.dll file under the <PPM_Home>/integration/webserverplugins/iis10/windows/x86-32/ directory (for 32-bite), or

     the <PPM_Home>/integration/webserverplugins/iis10/windows/x86-64/ directory (for 64-bite)

5. Right-click the Web site you created (or identified) in step b of step 1, 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.

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.

4. Click OK to close the window.

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

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. Create two files named isapi_redirect.properties and rewrites.properties in the <ISAPI_REDIRECTOR_HOME> directory.

   2. In the isapi_redirect.properties file, set the value of extension_uri to /jakarta/isapi_redirect.dll.

      Example: extension_uri=/jakarta/isapi_redirect.dll

   3. In the isapi_redirect.properties file, set the value of worker_file to the full directory path of workers.properties. That is, <ISAPI_REDIRECTOR_HOME>\workers.properties.

      Example: worker_file=C:\inetpub\scripts\workers.properties

   4. In the isapi_redirect.properties file, set the value of log_level to ERROR. (For more verbose logging, options include DEBUG and INFO.)

      Example: log_level=error

   5. In the isapi_redirect.properties file, set the value of log_file to the directory in which you want to save your log file. Include the log file name in the directory path.

      Example: log_file=C:\inetpub\scripts\isapi.log

   6. In the isapi_redirect.properties file, set the value of worker_mount_file to the full directory path of the uriworkermap.properties filex. That is, <ISAPI_REDIRECTOR_HOME>\uriworkermap.properties.

      Example: worker_mount_file=C:\inetpub\scripts\uriworkermap.properties

   7. In the isapi_redirect.properties file, set the value of rewrite_rule_file to the full directory path of the rewrites.properties file. That is, <ISAPI_REDIRECTOR_HOME>\rewrites.properties.

      Example: rewrite_rule_file=C:\inetpub\scripts\rewrites.properties

   Example: isapi_redirect.properties file sample

   # The path to the ISAPI Redirector Extension, relative to the website
   # This must be in a virtual directory with execute privileges
   extension_uri=/jakarta/isapi_redirect.dll
   # Full path to the workers.properties file
   worker_file=C:\inetpub\scripts\workers.properties
   # Log level (debug, info, warn, error or trace)
   log_level=error
   # Full path to the log file for the ISAPI Redirector
   log_file=C:\inetpub\scripts\isapi.log
   # Full path to the uriworkermap.properties file
   worker_mount_file=C:\inetpub\scripts\uriworkermap.properties
   rewrite_rule_file=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 step b of step 1, 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.

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.

Enable execution of ISAPI filter, as follows:

1. From the Connections pane of Internet Information Services (IIS) Manager, select the Web site (see step b of step 1).

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.

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 of Step 1. 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.

To make sure the IIS does not remove the JSON response content when the PPM server returns a 400 error, edit the web.config file, system.web Server section to set httpErrors existingResponse attribute to "PassThrough".

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

Start the PPM Server(s).

Stop the IIS 10 Web Server.

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

Enable 32-bit applications by doing either of the following:

• Change the default value of the application pool :

  1. Select Application Pools under your server.

     The Appliaction Pools pane is displayed in the center pane.

  2. Right-click in the center pane and select Set Application Pool Defaults from the menu displayed.
  3. Under General, set Enable 32-Bit Applications to True.

• Change the application pool that your Web site runs under:

  1. Select Application Pools under your server.
  2. Right-click the application pool that your Web site runs under and select Advanced Aettings from the menu displayed.
  3. Under General, set Enable 32-Bit Applications to True.