Configuring Microsoft IIS to Use Tomcat

You can use a Microsoft Internet Information Services (IIS) web server to deploy Uniface web applications. However, because IIS cannot execute servlets such as the Uniface WRD and SRD, it must redirect client requests to the Tomcat servlet engine. To do so it uses the Apache ISAPI Redirector, also known as the IIS connector.

The ISAPI Redirector and default configuration files are provided with the Tomcat installation. The redirector needs to be correctly configured before you can use IIS for your Uniface web applications.

Perform the following procedure if one of the following circumstances apply:

  • You plan to use the Microsoft Internet Information Services (IIS) web server with Tomcat as the servlet engine, where the Tomcat installation is not the one delivered with Uniface.
  • You chose the option Configure IIS for use with Uniface when installing the Uniface Enterprise Edition, but received the following error:

    IIS could not be configured for use with Uniface, either because IIS is not installed, or because the jakarta filter, the jakarta or the uniface virtual directory already exists within IIS.

Note: Steps 3-5 refer to a Tomcat worker process called uniface. You can replace uniface with the Tomcat worker process that you plan to use for any Uniface product.

Caution: The Tomcat webapp context and IIS virtual directory cannot share the same name.

To manually configure IIS

  1. If you are using a Tomcat installation other than that delivered by Uniface, copy the desired context files (such as uniface.xml) from UnifaceInstallDir\common\tomcat\conf\Catalina\localhost to a similar location in your Tomcat directory.
  2. Open the file isapi_redirect.properties (located in UnifaceInstallDir\common\tomcat\bin\w32|w64) in a text editor and ascertain the locations of the following files:
    • workers.properties—this is the value for the property worker file. The workers.properties file describes the hosts and ports used by the Tomcat worker process. A worker is a Tomcat process that accepts work from the IIS web server.
    • uriworkermap.properties—this is the value for property worker_mount_file. The uriworkermap.properties file maps URL path patterns to Tomcat worker processes.
  3. Edit the specified workers.properties file in a text editor.
    1. For each application, define a worker. For more information, consult the The Apache Tomcat Connector - Reference Guide: workers.properties configuration
    2. Locate the worker.list line and add the parameter uniface, separated by a comma from other parameters.

      For example:

      worker.list=worker.uniface,ajp13
    3. Save and close the file.
  4. Edit the uriworkermap.properties file to add URL path information for the ISAPI Tomcat redirector.
    1. Open the specified uriworkermap.properties file in a text editor and add the required worker mappings at the bottom of the file. For more information, consult the The Apache Tomcat Connector - Reference Guide: uriworkermap.properties configuration.

      For example:

      # --- Worker mappings for Uniface ---
/uniface/*=$(uniface.worker)

#--- End Uniface worker mappings ---
    2. Save and close the file.
  5. Apply the changes by stopping and restarting the World Wide Web Publishing Windows service and Tomcat.

For more information, consult the Tomcat documentation for IIS. For example: