JIRA 4.3 : Running multiple instances of JIRA on one machine
This page last changed on Feb 11, 2011 by dmeer.
It's possible to run multiple JIRA instances on one machine as long as the instance completes the following requirements:
By default, JIRA Standalone runs on port 8080 (and hence is available at (http://<yourserver>:8080, eg. http://localhost:8080). If you want to run another JIRA instance but already has a service claiming port 8080, there will be a conflict, and JIRA will fail to start. You may see errors like this: LifecycleException: Protocol handler initialization failed: java.net.BindException: Address already in use:8080 This can be fixed by changing JIRA to use another listening port (eg. 8090) and shutdown port (eg. 8015). This is done by editing conf\server.xml (eg. in Wordpad). The start of the file looks like: <Server port="8005" shutdown="SHUTDOWN"> <Service name="Catalina"> <Connector port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" /> Then restart JIRA (bin\shutdown.bat; bin\startup.bat) and point a browser to http://<yourserver>:8090 (eg. http://localhost:8090).
Which port number should I choose? If you are not sure which port number to choose, use a tool such as netstat to determine which port numbers are free to use by JIRA. The highest port number that can be used is 65535 because it is the highest number which can be represented by an unsigned 16 bit binary number. The Internet Assigned Numbers Authority (IANA) lists the registration of commonly used port numbers for well-known Internet services, it's advisable to avoid any of those ports. |
![]() |
Document generated by Confluence on Mar 27, 2011 18:52 |