JIRA Displays an Error Banner about the incorrect Tomcat config

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform Notice: Server and Data Center Only - This article only applies to Atlassian products on the server and data center platforms.

Symptoms

JIRA displays the following message to administrators:

Tomcat config is incorrect

The Tomcat server.xml has an incorrect configuration:

scheme should be '<recommended scheme>'
proxyName should be '<recommended proxyName>'
proxyPort should be '<recommended proxyPort>'

Cause 1

This message appears when Jira attempts to check that the URL you are using to access Jira is the same as Jira's base URL, but cannot complete the check because of a problem with your proxy configuration. This is usually because:

  • proxyName and proxyPort are present in your <install-directory>/conf/server.xml file but you are not using a reverse proxy.
  • you are using a reverse proxy, but the values for proxyName and proxyPort  are incorrect in your <install-directory>/conf/server.xml file. 

Cause 2

  • This message can appear also if there's an active duplicate connector in server.xml. I.e. it would appear like this:


    Notice the connector ports are the same which is incorrect

Resolution

Cause 1

If you are not using a reverse proxy, make sure the proxyName and proxyPort attributes are not included.  Your connector should look similar to the example below if you are not using a reverse proxy:

<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
     maxThreads="48" minSpareThreads="10"
     enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
     protocol="org.apache.coyote.http11.Http11NioProtocol" />

If you are using a reverse proxy, make sure the the proxyName and proxyPort attributes have correct values for your reverse proxy.  Your connector should look similar to the example below, and the recommended settings will be displayed in the warning.

<Connector port="8090" connectionTimeout="20000" redirectPort="8443"
     maxThreads="48" minSpareThreads="10"
     enableLookups="false" acceptCount="10" debug="0" URIEncoding="UTF-8"
     protocol="org.apache.coyote.http11.Http11NioProtocol" 
     proxyName="www.example.com" proxyPort="80" scheme="http"/>

If you still see this error after checking your server.xml, check your proxy configuration is also correct. The following pages provide example configurations.

Cause 2

Either change the connector port on one the connectors, or comment out the redundant connector and restart Jira

Workaround for Cause 1:

If the Base URL check continues to detect a problem, you can disable the check in your site:

  1. Go to  > Add-ons > System
  2. Disable the Jira Base URL plugin system add-on. 

The base URL warning should no longer appear. 

(info) Please be aware that the proxyName is case-sensitive and must match the Base URL of the JIRA instance. For example, a proxyName of ServerName will not match a Base URL of http://ServerName.com. To fix this, change the proxyName to servername.




Last modified on Mar 3, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.