Web - IIS and Tomcat Integration

From fmepedia

 (http://fmepedia.com/index.php/Category:FME_Server)

Verified on Windows 2003 Server R2 with IIS 6.0, JRE 6u5, Tomcat 5.5.26, isapi_redirect 1.2.26 and FME Server 2009 B5649_5904

Table of contents

1 Prerequisites 1.1 JDK/JRE installed 1.2 Tomcat installed 1.3 Tomcat connector / IIS Redirector 1.4 Sample configuration files 2 Steps to integrate IIS and Tomcat 2.1 Configuration at Tomcat side 2.2 Configuration at IIS side

Prerequisites

JDK/JRE installed

Tomcat installed

1. You may want to set the service Startup Type as Automatic since FME Server has to run on it.

2. Make a note for port number if it is changed from default 8080 to others. You will need this port number during the FME Server installation progress.

Tomcat connector / IIS Redirector

Quick link to connector isapi_redirector.dll (http://www.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/)

Sample configuration files

Here is a zip file with samples

Steps to integrate IIS and Tomcat

Configuration at Tomcat side

1. Navigate to <Tomcat Installed Dir>\bin folder.
   
2. Create a subfolder named win32 within 'bin'
   
3. Copy the isapi_redirect_(version).dll into <Tomcat Installed Dir>\bin\win32\
   
4. Rename the above file to isapi_redirect.dll
   
5. Unzip the download iis_tomcat_samples.zip to a temp folder.
   
6. Copy the isapi_redirect.properties file from the temp folder into <Tomcat Installed Dir>\bin\win32\
7. Open the isapi_redirect.properties file to ensure that paths are set correctly.
8. Copy the uriworkermap.properties and workers.properties files from temp folder into <Tomcat Installed Dir>\conf\
   
9. Add the contexts for new FME Server application to the uriworkermap.properties file making sure not to include the fmedatadownloadresult folder in this filter. You can exclude this by including !/fmedatadownloadresults/*=wlb e.g.:

/fmeserver/*=wlb
/fmeserver=wlb
!/fmedatadownloadresults/*=wlb

• for DDE and SpatialDirect simply replace fmeserver with DDE or SpatialDirect.
• IIS may not allow the download of .log files when using the SpatialDirect service. This can be overcome by adding the .MIME type .log to the IIS mime types

Note: At this point, it may be necessary to review permissions of added properties and dll files to ensure the IIS service user (usually Network Service) and internet guest user have read/execute permissions on those files.

---

Configuration at IIS side

1. Open the Internet Information Services(IIS) manager.
   
2. Browse to <server name> -> Web Sites
   
3. Right click on Default Web Site, then select New -> Virtual Directory.
   
4. Enter Jakarta for Alias name and select <Tomcat installed Dir>\bin\win32 as directory.
   
5. For the permission page, select both Read and Execute check boxes.
   
6. Click Finish and close the dialog.
   
7. Right click on Default Web Site, and select properties.
   
8. In the popup dialog, select the ISAPI Filters tab.
   
9. Click Add.
   
10. Enter Jakarta for Filter name, and <Tomcat Installed Dir>\bin\win32\isapi_redirect.dll as executable.
    
11. Click Apply and close the dialog box.
    
12. Right click on Web Service Extensions and select Add a new Web service extension
    
13. Enter Jakarta for Extension Name, and add <Tomcat Installed Dir>\bin\win32\isapi_redirect.dll for required files field.
    
14. Select the Set extension status to Allowed check box and click OK to close the dialog box
    
15. Stop and restart the Default Web Site by right clicking on it and select Stop and Start.
    
16. If everything is setup correctly, you should be able to access the Tomcat manager servlet at http://<Server_Name>/manager/status
17. Now, you are ready to install FME Server.