How can I run JIRA on Windows via a subdomain?

Question

I am looking around the JIRA documentation but I cannot find any information on this, but perhaps I'm not searching for the right terms :(

I've heard something about the concept of VirtualHosts in the Confluence documentation but I don't really know where to start; I'm traditionally a .NET developer =)

My JIRA is up and running, i am aware of the xml configuration files in the JIRA\conf directory and can edit what is required.

I have pointed http://jira.mydomain.com to our public IP and am ready to go. It's currently running on http://localhost:8085.

Update: This question is 6 days old and would really love some help, anyone? :|

Thanks in advance.

Answer 1

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:

1. 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 jira.yourdomain.com.
2. 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.
3. Ensure your JIRA\conf\server.xml file 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.
4. 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!