Integrating Microsoft IIS with Connect Daily using Apache Tomcat

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\jakarta-tomcat-x.x.x

CATALINA_BASE

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

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 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 IUSER_<MACHINE_NAME>. Select the User, click Add, and finally, click OK.
5. Repeat steps 1-4 for the $CATALINA_BASE directory.

Repeat steps 1-4 for the $CATALINA_BASE\logs, $CATALINA_BASE\temp, and $CATALINA_BASE\work sub-directories. For these directories, ensure that IUSER_ is granted write permissions to the directory.

Step 2 - Create the Jakarta Virtual Directory

1. Open the Windows Internet Information Services Manager and right click on the virtual host (or default website) for the calendar. From the popup menu, select New -> Virtual Directory.
2. Enter a virtual directory name of jakarta. You must type the directory name in precisely as shown.
3. For the directory choose $CATALINA_HOME\bin\native.
4. Assign "Allow Execute Access" permissions to the directory.
5. Complete the dialog by clicking on OK or Finish.

Step 3 - Install the ISAPI Redirector Filter

1. Right click on the Virtual host again and choose properties. When the properties dialog box appears, select the ISAPI Filters tab.
   Click on the Add button. Enter a name like "Jakarta Redirector". For the "Executable", click on the "Browse" button and navigate to the $CATALINA_HOME\bin\native directory and select the file isapi_redirect.dll.
2. Select OK and click on Apply.
3. For IIS 6.0, skip to step 4. For other versions, restart the web service. Open the properties dialog again for the Virtual Host, and ensure that there is a green up-arrow on the ISAPI Filters tab for the Jakarta Redirector.
4. Go to Step 5 - Test Installation.

Step 4 - Windows 2003/IIS 6 Only

1. In the left pane of the IIS manager, select Web Service Extensions and select Add a new Web service extension.
2. Name the extension Jakarta-Tomcat and add the $CATALINA_HOME\bin\native\isapi_redirect.dll to the required files section.
3. Check the box for set extension status to Allowed.
4. Restart the web service.

Step 5 - 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\cdaily.xml file to the desired name.

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.