Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column

This page describes how to configure Microsoft's IIS web server and Live Forms and  such that IIS forwards requests on to Live Forms , and responds back to the user.

Live Forms is  is written in Java, and needs a Java Application Server (servlet container) to run. As IIS does not provide services of a Java Application Server, it is not possible to deploy Live Forms deploy  directly into IIS. It is possible, however, to configure IIS to proxy requests for Live Forms for  to an application server where Live Forms where  is deployed. If you are not using the standalone Live Forms standalone  distribution with Tomcat, please consult your application server's documentation to determine whether it is possible to integrate with IIS and how to achieve it. Also note that this is a guideline on how enable the interaction between Live Forms between  and IIS.

Column
width240px

On this page:

Table of Contents
maxLevel1

Install and Configure

...

the Form Server

IIS configuration is a complex task. The integration steps below relating to your IIS web server should be performed by your IIS Web System Administrator. 

Note

It is very important that you first follow the basic Live Forms basic  Installation & Configuration and verify that Live Forms that  works by itself by pointing a browser to http://localhost:8082/frevvo/web/login.

...

Download and Configure an ISAPI Filter

  1. Download Live Forms Download  isapi package [http://www.frevvo.com/bucket/isapi/isapi.zip here]. The archive is a pre-packaged isapi filter along with a recommended directory structure and pre-configured files. It is a starting point.
  2. Expand the archive. For the sake of this document we will assume the archive is expanded under your "c:\" drive. If you do that, you should have a folder c:\isapi after expanding. 
  3. The isapi archive contains version 1.2.28 of the isapi connector for win 32. If you need to upgrade and/or IIS is running on win64, download the ISAPI Redirect DLL from the [[http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/ Apache ]] site. If you download a new isapi filter:  
    1. When downloading, choose the version of Windows that IIS is running on (either win32 or win64), and then choose the latest available jk version. 
    2. The file to download is named isapi_redirect_X.X.X.dll, where 'X.X.X' is the version number. You will need to remove the version number from the DLL file (i.e. it needs to be named isapi_redirect.dll). 
    3. After downloading and renaming, update the dll in c:\isapi\bin. 
  4. Under c:\isapi\bin you will find isapi_redirect.properties (shown below). If you expanded the filter in c:\isapi you don't have to change anything. Otherwise, just edit the paths accordingly.

...

 The file c:\isap\conf\uriworkmap.properties lists the http request paths that will be forwarded to Live Forms

Code Block
/frevvo/*=workerFrevvo

...

  1. Open Control Panel, then Administrative Tools and open Internet Information Services.
  2. Add the ISAPI Filter to IIS
    1. Right-click on Default Web Site (or the Web Site that should be responsible for proxying requests to Live Forms ), and click on Properties.
    2. Click the ISAPI Filters tab.
    3. Click Add and create one. Enter jakarta as the Filter Name and enter the location of the isapi_redirect.dll file for the executable.
    4. Click OK, Apply and then OK.

...

  • Create a virtual directory for Live Forms in for in IIS. 
    1. Right-click on Default Web Site (or the Web Site that should be responsible for proxying requests to Live Forms ), choose New and then Virtual Directory.
    2. Go through the creation wizard. Set the alias to be the same as the context path configured in c:\isapi\bin\isapi_redirect.properties. If you kept the defaults in the section Download and Configure an ISAPI Filter you would enter jakarta.

 

  • Enter the path to the directory that contains the isapi_redirect.dll

...

  1. Navigate to Start > Administrative Tools > Internet Information Services (IIS) Manager
  2. Click the Default Web Site (or the Web Site that should be responsible for proxying requests to Live Forms ), and click on ISAPI Filters (on the right panel).
  3. Check if there is a Filter that points to the isapi_redirect.dll file and that it is in the right location. If not, click Add and create one. Enter '''jakarta''' as the Filter Name and enter the location of the isapi_redirect.dll file.
  4. Click OK.

...

  1. Right-click on Default Web Site (or the Web Site that should be responsible for proxying requests to Live Forms )
  2. Click on '''Add Virtual Directory'''
  3. Configure the alias to '''jakarta'''
  4. Set the path to c:\isapi\bin

...

  1. Navigate to Start Menu > Administrative Tools > Server Manager.
  2. In the Server Manager, click on Roles and right click Web Server (IIS).
  3. On the right panel, look for the section System Services.
  4. Restart World Wide Web Publishing Service.

If you already installed Live Forms installed  you can test the IIS configuration by pointing your browser to: http://localhost/frevvo/web/static/home

...