Bypass a proxy or SSL to test network connectivity for Jira Server and Data Center

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.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Purpose

Sometimes it's necessary to test connectivity to a single application from a single workstation. The methods described in this article should only be used if you need to test connectivity from a single workstation. To bypass a Proxy and SSL, you will need to make sure if there is a non-proxy port configured on Tomcat or you should add a secondary connector to Tomcat that allows for an alternate route of communication to the application.

Solution

For this example, let's say

Please follow the steps below to bypass SSL and Proxy:

  1. Stop JIRA.
  2. Open JIRA Installation Directory/conf/server.xml in a text editor.
  3. Verify if the following Connector port exist in the file:
    For JIRA Software version 7.12.3 and above:

    <Connector port="8081"
                       maxThreads="150"
                       minSpareThreads="25"
                       connectionTimeout="20000"
                       enableLookups="false"
                       maxHttpHeaderSize="8192"
                       protocol="HTTP/1.1"
                       useBodyEncodingForURI="true"
                       acceptCount="100"
                       disableUploadTimeout="true"
                       relaxedPathChars="[]|" 
                       relaxedQueryChars="[]|{}^&#x5c;&#x60;&quot;&lt;&gt;"/>


    For JIRA version lower than 7.12.3

    <Connector port="8081"
                       maxThreads="150"
                       minSpareThreads="25"
                       connectionTimeout="20000"
                       enableLookups="false"
                       maxHttpHeaderSize="8192"
                       protocol="HTTP/1.1"
                       useBodyEncodingForURI="true"
                       acceptCount="100"
                       disableUploadTimeout="true"/>

    The Connector port might be different, as long as the connector is not configured with SSL or Proxy, then you should be able to bypass the Proxy and SSL. In this case, you should be able to access JIRA with the following URL:  http://192.168.1.100:<connector port>

    Please backup the current server.xml

  4. If such Connector port does not exist in the server.xml file, then please add the connector by copy-pasting the above connector to the server.xml . Make sure to use the correct connector syntax (depending on the version of JIRA) and port 8081 is not already in use (simply search for 8081 in your connector and use 'netstat -an' command to verify if nothing else is listening on that port. If the port is already used, please use a different port.

  5. Start JIRA.

  6. Access JIRA with the following URL:  http://192.168.1.100:8081

    Change the 8081 port to the respective value if you have configured the port differently.

  7. Change the base URL to http://192.168.1.100:8081
  8. After the test, you should either:

    • Remove the connector port from the server.xml file.
    • Restore the content of the server.xml file from the backup server.xml file.

      Please take note that you will need to restart JIRA for the changes to be committed.

DescriptionSometimes it's necessary to test connectivity to a single application from a single workstation. The methods described in this article should only be used if you need to test connectivity from a single workstation. To bypass a Proxy and SSL, you will need to make sure if there is a non-proxy port configured on Tomcat or you should add a secondary connector to Tomcat that allows for an alternate route of communication to the application.
ProductJira, Confluence, Bamboo, Bitbucket, Crowd, Fisheye, Crucible
PlatformServer
Last modified on Oct 9, 2024

Was this helpful?

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