In case anyone wants to know, the best method I found was to use the Tomcat IIS Connector via JIRA's wiki documentation on Integrating JIRA with IIS.
This allows you to run on a /jira sub directory, or http://jira.domain.com sub-domain/virtual host if you so wish.
Utilising a sub-domain is not detailed in the wiki, only getting IIS to proxy requests to Tomcat through a sub-directory, so if you wish to use a sub-domain, follow the instructions as per normal but observing the following tips:
- This is a general point - Ensure on the IIS Site you are told to create, the binding is mapped to port
80 with a host header of
- In your
JIRA\conf\server.xml file leave the path empty for the
<Context path=""...> attribute where the wiki documentation tells you to specify one. Only enter one such as
/jira for eg. if you are using sub-directories.
- Ensure your
port attribute of the
<Connector...> element is set to something other than
80 which IIS will be running on. For instance the default I believe installs to
8080 so leave it at that.
- Lastly, in your
tomcat_iis_connector\conf\uriworkermap.properties folder used for the ISAPI proxy filter, make sure your worker entry is listed as:
/*=worker1 and not
/jira/*=worker1 which the documentation suggests you do.
That should be it, now run an
iisreset and reboot of your JIRA service and you're good to go. Can't believe this isn't really detailed on the net or the sub-domain option wasn't detailed in the Atlassian Wiki. Perhaps it's simple to those familiar with Tomcat, I'm not sure!
Best of luck and hope you don't have the headache I had!