How to change Base URL?

[Taras Kuzmuk]

Hi,

We have JIRA installed on https://jira.aaa.company.com, we need to shrink that URL to https://jira.company.com

I know we need to change a base URL in JIRA configuration from a webUI. But how do we change our current tomcat settings to reflect our requested url of https://jira.company.com/? I know it's being done somewhere in  server.xml file, but what exactly need to be changed there?

Thanks in advance!

Rgds

Taras

[David Di Blasio]

Hi Taras,
Thanks for the confirmation. The top level view is that you'll need to have a reverse proxy listening on https://jira.company.com, and then the server.xml will need to have this proxy server added to the configuration like the following example.

<Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true" 
scheme="https" proxyName="jira.company.com" proxyPort="443" secure="true"/>

Once this is done you can simply change your base_url to reflect this change. Additional information on this configuration can be found in the following article.

https://confluence.atlassian.com/display/JIRA/Integrating+JIRA+with+Apache+using+SSL

Let us know if this helps :).

[Taras Kuzmuk]

Hi David, Thanks for your answer. I'll definatelly let you know if that worked when I have a chance to try it. One thing that I'm not sure about now is if we have some kind of reverse proxy, because I'm really familiar with what our customer has installed. Today I was told that they just installed whatever was in a package with Jira, I can tell it's a Tomcat but not sure if it's working as a reverse proxy. Could you please advice if it's working as a reverse proxy out of the box?

[David Di Blasio]

Hi Taras, A vanilla installation of JIRA does not have any sort of reverse proxy, and just uses a Tomcat webserver. This server by default will listen on port 8080, which would mean your customers would need to navigate to the url plus the port. Many organizations choose to add their own reverse proxy in front of JIRA for more control over security, and to proxy from a public facing url like https://jira.company.com/ to JIRA (which would be on servername:8080).

[Taras Kuzmuk]

So as far as I understood to change a URL of Jira I have to 1. Change DNS records 2. Log in and change BASE URL's from a Web UI 3. Edit server.xml and change proxyName parameter Could you please confirm if that's the case? Just in case something will go wrong what is the recomended recovery plan, so that I can have Jira up and running asap?

[David Di Blasio]

Hi Tara, 

At first glance it looks like you might have a reverse proxy such as Apache set up in front of JIRA. If this is the case the modification would need to occur at the proxy, and at the server.xml level for the change to be effective. Can you confirm if this is the case?

[Taras Kuzmuk]

Hi David, Confirm.