Troubleshoot port conflict with other products
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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
Summary
Express patching functionality in Microsoft System Center Configuration Manager (SCCM) uses port 8005; Tomcat is not able to bind to this port.
Environment
The issue could impact multiple Jira versions
Diagnosis
Reviewing the $JIRA_INTALL/logs/catalina.out, we can see the error message
1
2
27-Sep-2022 09:04:41.994 SEVERE [main] org.apache.catalina.core.StandardServer.await Failed to create server shutdown socket on address [localhost] and port [8005] (base port [8005] and offset [0])
java.net.BindException: Address already in use: NET_Bind Cause
When using the new Express patching functionality in SCCM Current Branch, it uses port 8005 and Tomcat is not able to bind the port.
The Port is not documented though and since it is an SCCM Port (even if it can be changed, still need to be added) as it is required for "Express Updates".
Solution
1 - Ask the SCCM admin to change the port from 8005 to another one
2 - Edit the $JIRA_INSTALL/conf/server.xml
Change the Server port="8005" to Server port="8006"
Save server.xml
Start Jira
e.g:
1
2
3
4
5
6
<Server port="8006" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener"/>
<Listener SSLEngine="on" className="org.apache.catalina.core.AprLifecycleListener"/>
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener"/>
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener"/>
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener"/>Was this helpful?