How to change Base URL?

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

2 answers

0 vote

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?

Hi David, Confirm.

0 vote

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 :).

 

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?

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).

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?

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,316 views 14 20
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot