The Atlassian suite of applications (JIRA, Confluence, Crowd, FishEye/Crucibleand Bamboo) is an amazing set of tools for anyone trying to run a halfway serious development shop.
The easiest way to get started is to install the “standalone” versions, which essentially means each application comes in its own Tomcat instance - this allows for seperation of your application JVMs and gets you the ability to restart just the application you want when doing maintenance (not to mention the fact that I find the deployment instructions for their non-standalone version a bit long-winded).
The problem with this approach is that each application will, by default, end up running in the root context (/) of its own port. So, your JIRA instance might be athttp://your.server.name:8080 and your Confluence might be athttp://your.server.name:9080 (and so on and so forth).
I have found that the simplest solution is to put everything behind an Apache proxy so that you can run the whole thing on port 80 with the various applications on their own paths (“/jira”, “/confluence”, etc).
The first step is that you need to modify the “server.xml” for each of your applications to run them on something other than “/”. To do this, look for the following:
and change it to something like:
Once you restart the applications, they’ll now be available on the port at the path you’ve just configured - something like http://your.server.name:8080/jira.
The second step is actually pretty straightforward. You’ll need an install of Apache with mod_proxy enabled. Within the VirtualHost section of your Apache config files, you’ll want to put the following:
ProxyPass /jira http://localhost:8080/jira
ProxyPassReverse /jira http://localhost:8080/jira
ProxyPass /confluence http://localhost:9080/confluence
ProxyPassReverse /confluence http://localhost:9080/confluence
Once you restart Apache (and assuming it’s listening on port 80), you can now browse to http://your.server.name/jira and http://your.server.name/confluence.
Don’t forget to update the server urls in the Administration sections of the various applications to make sure that things like emails and RSS feeds and things like that all have the appropriate links.