Difference between revisions of "Jetty/Howto/Deploy 3rd Party Products/JIRA"

Revision as of 13:23, 21 July 2009

How to Deploy JIRA

These instructions have been tested against:

Steps

Prepare the JIRA Web Application

Start from the JIRA Standalone Distribution, and:

• Copy $JIRA/common/lib/hsqldb-1.8.0.5.jar to $JETTY/lib/ext/hsqldb/hsqldb-1.8.0.5.jar (create the directories as needed)
• Copy $JIRA/atlassian-jira to $JETTY/contexts-available/atlassian-jira
• Modify $JETTY/contexts-available/atlassian-jira/WEB-INF/web.xml:
  • add a <resource-ref> element for the datasource:

    <resource-ref>

    <res-ref-name>jdbc/JiraDS</res-ref-name>

    <res-type>javax.sql.DataSource</res-type>

    <res-auth>SERVLET</res-auth>

    </resource-ref>

  • if you want to use JavaMail Session, add a <resource-ref> for it too:

    <resource-ref>

    <res-ref-name>mail/Session</res-ref-name>

    <res-type>javax.mail.Session</res-type>

    <res-auth>SERVLET</res-auth>

    </resource-ref>

• Modify $JETTY/contexts-available/atlassian-jira/WEB-INF/classes/entityengine.xml:
  • modify the JNDI name for the user transaction from java:comp/env/UserTransaction to java:comp/UserTransaction
  • make sure the JNDI name for the data source is java:comp/env/jdbc/JiraDS
• Setup the transaction manager:
  • unzip and copy jta.properties to $JETTY/resources
  • download Atomikos TransactionEssentials and copy:
    • $ATOMIKOS/dist/transactions-essentials-all.jar to $JETTY/lib/ext/atomikos/transactions-essentials-all.jar (create the directories as needed)
    • $ATOMIKOS/lib/jta.jar to $JETTY/lib/ext/atomikos/jta.jar (or alternatively make sure the JTA classes are available to Jetty)
• Create the context file $JETTY/contexts/jira.xml and copy the following:

  <?xml version="1.0"  encoding="UTF-8"?>

  <!DOCTYPE Configure PUBLIC "-//Jetty//Configure//EN" "http

  //www.eclipse.org/jetty/configure.dtd">

  <Configure class="org.eclipse.jetty.webapp.WebAppContext">

  <Call class="java.lang.System" name="setProperty">

  <Arg>com.atomikos.icatch.file</Arg>

  <Arg><SystemProperty name="jetty.home" default="." />/resources/jta.properties</Arg>

  </Call>

  <New id="user-tx" class="org.eclipse.jetty.plus.jndi.Transaction">

  <Arg>

  <New class="com.atomikos.icatch.jta.UserTransactionImp" />

  </Arg>

  </New>

  <New id="jira-ds" class="org.eclipse.jetty.plus.jndi.Resource">

  <Arg>jdbc/JiraDS</Arg>

  <Arg>

  <New class="com.atomikos.jdbc.nonxa.NonXADataSourceBean">

  <Set name="Url">jdbc

  hsqldb:./database/jiradb</Set>

  <Set name="driverClassName">org.hsqldb.jdbcDriver</Set>

  <Set name="user">sa</Set>

  </New>

  </Arg>

  </New>

  <Set name="contextPath">/jira</Set>

  <Set name="resourceBase"><SystemProperty name="jetty.home" default="."/>/contexts-available/atlassian-jira/</Set>

  <Set name="configurationClasses">

  <Array type="java.lang.String">

  <Item>org.eclipse.jetty.webapp.WebInfConfiguration</Item>

  <Item>org.eclipse.jetty.webapp.WebXmlConfiguration</Item>

  <Item>org.eclipse.jetty.webapp.MetaInfConfiguration</Item>

  <Item>org.eclipse.jetty.webapp.FragmentConfiguration</Item>

  <Item>org.eclipse.jetty.plus.webapp.EnvConfiguration</Item>

  <Item>org.eclipse.jetty.plus.webapp.Configuration</Item>

  <Item>org.eclipse.jetty.webapp.JettyWebXmlConfiguration</Item>

  <Item>org.eclipse.jetty.webapp.TagLibConfiguration</Item>

  </Array>

  </Set>

  </Configure>