Integrating Microsoft IIS 7 with Connect Daily

Throughout these instructions, there will be references to $CATALINA_HOME and $CATALINA_BASE as the base portion for the file and directory paths displayed. For most installations these variables refer to:

CATALINA_HOME

C:\Program Files\MH Software\Connect Daily\apache-tomcat-x.x.x-mhs

CATALINA_BASE

C:\Program Files\MH Software\Connect Daily\TCBase

Note

For 64-bit Windows, the default path will be C:\Program Files (x86)\...

Step 1 - Set Permissions

1. Using Windows Explorer, navigate to the $CATALINA_HOME directory. Right click on the folder and choose properties.
2. Change to the Security tab of the properties dialog.
3. Click on the Edit button and then the Add button. If necessary, change the "Look In" dropdown to refer to the local machine.
4. Locate the account your IIS Server runs under. Generally, the account name will be IUSR. Select the User, click Add, and finally, click OK.
5. Repeat steps 1-4 for the $CATALINA_BASE directory.
6. Repeat steps 1-4 for the $CATALINA_BASE\logs sub-directory. For this directory, ensure that IUSR is granted write permissions to the directory.

Step 2 - Create the Jakarta Application

1. From the Start menu, choose Administrative Tools, and then select Internet Information Services Manager.
2. From the sites list, select the site (or Default Web Site) for the calendar. Right click on the desired site. From the popup menu, select Add Application...
3. Enter an alias of jakarta. You must type the directory name precisely as shown. The name must be all lower case as shown.
4. For the physical path choose $CATALINA_HOME\bin and click on OK.

Step 3 - Install the ISAPI Redirector Filter

1. Click on the site in the left pane and then in the right pane, double-click on the ISAPI Filters icon.
2. Now, right-click in the ISAPI Filters pane and select Add. For Filter Name, enter Tomcat Redirector. For executable, select $CATALINA_HOME\bin\isapi_redirect.dll and click on OK.
3. Click on the site in the left pane and then in the right pane, double-click on the Handler Mappings icon.
   
   Right click on the handler mappings section and choose "Add Module Mapping..."
   
   For Request path, enter *.dll
   
   From the Module dropdown list, select "IsapiModule". DO NOT SELECT "IsapiFilterModule", it's not the same thing.
   
   For Executable, select $CATALINA_HOME\bin\isapi_redirct.dll
   
   For Name, enter "Tomcat Redirector" and click on OK.
   
   A dialog will appear asking if you want to allow this ISAPI extension. Select "Yes"

Step 4 - Test Installation

If you have Tomcat running (either standalone or as a service), you should now be able to connect to the machine and access the calendar. Open a browser, and enter the URL

http://<host name>/calendar/login.html

You should be presented with the calendar login screen.

If you wish to change the request URI prefix from /calendar/ to something else you will have to edit the file $CATALINA_BASE\conf\uriworkermap.properties, and change the path component of the context in the $CATALINA_BASE\conf\Catalina\localhost\calendar.xml file to the desired name. You will also have to rename the file calendar.xml to <path>.xml.

If you are no longer using the HTTP connector Tomcat runs on port 8080, you can disable it by editing the $CATALINA_BASE\conf\server.xml file.