Installing JIRA on JBoss 3
| 
PDF |
These instructions will help you install JIRA on JBoss
3.0.x (with embedded Jetty or Tomcat). These instructions have been udpated to work with JBoss 3.0.4 with embedded Tomcat 4.1.12
There is also separate
guide for installing JIRA on JBoss 2.4, but we recommend using JBoss 3.0 rather than JBoss 2.4 if you can.
Both JIRA and JBoss can be setup in many ways - this is just one configuration
that we have found works consistently for us.
If you're having problems, see debugging
JIRA.
|
1.1 Modify transaction factory attribute
| |
| | |
Modify the transaction factory in the entityengine.xml file,
located in the edit-webapp/WEB-INF/classes directory. Changes to be made are shown in bold.
<transaction-factory> tag:
<transaction-factory
class="org.ofbiz.core.entity.transaction.JNDIFactory">
<user-transaction-jndi jndi-server-name="default"
jndi-name="UserTransaction" />
<transaction-manager-jndi jndi-server-name="default"
jndi-name="java:/TransactionManager" />
</transaction-factory>
|
1.2 Modify datasource attributes
| |
| | |
By default, JBoss comes with a hsql
datasource located at java:/DefaultDS. These instructions use that
datasource. Alternatively, you can add your own datasource within JBoss and
use that.
Here's the relevant section of the entityengine.xml file:
<datasource name="defaultDS"
helper-class="org.ofbiz.core.entity.GenericHelperDAO"
field-type-name="hsql" check-on-start="true"
add-missing-on-start="true">
<jndi-jdbc jndi-server-name="default"
jndi-name="java:/DefaultDS" />
</datasource>
Build JIRA by entering 'ant ear' on the command line, in the directory where you originally extracted JIRA to. This will produce the EAR to deploy
in the dist directory. If you don't have ant you can download it from here
|
3. (optional) Remove old deployments
| |
| | |
On some versions of JBoss you may need to undeploy any old JIRA EARs and remove
all deployed files before deploying the new EAR.
|
4. Deploy the EAR in JBoss
| |
| | |
Drop the EAR generated into your deployment directory. By default on JBoss
3 that's jboss/server/default/deploy directory. You should see
messages on the JBoss console saying that it is deploying the EAR.
Start JBOSS 3.0.4 by running bin/run.bat under the JBoss directory. JIRA should now be accessible at http://localhost:8080/jira/ (change
the host and port as needed).
