Map JIRA Standalone to IIS6

2009 September 28
tags: Other · Windows
by Josh Hand

> JIRA

1. Edit conf/server.xml and ensure there is no context path set.

<Context path="" docBase="${catalina.home}/atlassian-jira" swallowOutput="true" reloadable="false">

> Tomcat

1. Edit conf/server.xml and ensure the AJP/1.3 Connector node is uncommented.

<Connector port="8009" enableLookups="false" redirectPort="8443" protocol="AJP/1.3" />

> Connector

1. Create the following directories and files (update paths if required):

-tomcat_iis_connector (dir)
--conf (dir)
---uriworkermap.properties (blank file)
---workers.properties.minimal (blank file)
--logs (empty dir)
-isapi_redirect.properties (blank file)

2. Download the appropriate ISAPI Redirect DLL from apache.

3. Rename the DLL to isapi_redirect.dll and place in the tomcat_iis_connector directory.

4. Populate the blank files created in step 1 with the following.

>isapi_redirect.properties:

-----------------------------------------------------------------------
# Configuration file for the Jakarta ISAPI Redirector
# The path to the ISAPI Redirector Extension, relative to the website
# This must be in a virtual directory with execute privileges

extension_uri=/jakarta/isapi_redirect.dll

# Full path to the log file for the ISAPI Redirector

log_file=C:\tomcat_iis_connector\logs\isapi_redirect.log

# Log level (debug, info, warn, error or trace)

log_level=info

# Full path to the workers.properties file

worker_file=C:\tomcat_iis_connector\conf\workers.properties.minimal

# Full path to the uriworkermap.properties file

worker_mount_file=C:\tomcat_iis_connector\conf\uriworkermap.properties
-----------------------------------------------------------------------

>uriworkermap.properties

-----------------------------------------------------------------------
# uriworkermap.properties - IIS #
# This file provides mappings for the workers
# defined in workermap.properties.minimal.
# The general syntax for this file is:
# [URL]=[Worker name]
/*=worker1
-----------------------------------------------------------------------

>workers.properties.minimal

-----------------------------------------------------------------------
# workers.properties.minimal - #
# This file provides minimal jk configuration properties needed to
# connect to Tomcat. #

# The workers that jk should create and work with.
#

worker.list=worker1

#
# Defining a worker named worker1 and of type ajp13.
# Note that the name and the type do not have to match.
#

worker.worker1.type=ajp13
worker.worker1.host=localhost
worker.worker1.port=8009
-----------------------------------------------------------------------

> IIS

1. Create an IIS website and point it's home directory to jira's webroot.

C:\jira36\atlassian-jira-enterprise-3.6-standalone\atlassian-jira

2. Create a Virtual Directory call jakarta and point it to your connector folder.

C:\tomcat_iis_connector

3. Against your IIS website add a Wildcard application map (Properties/Home Directory/Configuration) that points to the redirect DLL.

C:\tomcat_iis_connector\isapi_redirect.dll

4. Add a IIS web service extension in for tomcat.

Extension Name: tomcat
Required Files: C:\tomcat_iis_connector\isapi_redirect.dll
Set extension status to Allowed: Yes

5. Restart JIRA and IIS Admin Services and your away.

1 Response leave one →
  1. Dann
    Feb 18, 2010 at 7:34 PM

    Thanks for this! Spent way too many hours on doing this. I used this for IIS 7, but had a few issues to do with file permissions (solved by changing the security to allow IUSR to access things) and having to add ISAPI_Redirect as a filter for the site.

    Didnt realise you were another kiwi till I got to the end either.

Leave a Reply