Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

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

Line 19: Line 19:
 
* Copy <tt>$JIRA/atlassian-jira</tt> to <tt>$JETTY/contexts-available/atlassian-jira</tt>
 
* Copy <tt>$JIRA/atlassian-jira</tt> to <tt>$JETTY/contexts-available/atlassian-jira</tt>
 
* Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/web.xml</tt>:
 
* Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/web.xml</tt>:
** add a <tt>&lt;resource-ref&gt;</tt> element for the datasource: <pre><nowiki>
+
** add a <tt>&lt;resource-ref&gt;</tt> element for the datasource:  
<resource-ref>
+
**; <pre><resource-ref>
    <res-ref-name>jdbc/JiraDS</res-ref-name>
+
**;    <res-ref-name>jdbc/JiraDS</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
+
**;    <res-type>javax.sql.DataSource</res-type>
    <res-auth>SERVLET</res-auth>
+
**;    <res-auth>SERVLET</res-auth>
</resource-ref>
+
**;</resource-ref></pre>
</nowiki></pre>
+
 
** if you want to use JavaMail Session, add a <tt>&lt;resource-ref&gt;</tt> for it too:
 
** if you want to use JavaMail Session, add a <tt>&lt;resource-ref&gt;</tt> for it too:
 
**; <pre><resource-ref>
 
**; <pre><resource-ref>
Line 85: Line 84:
 
*;    </Set>
 
*;    </Set>
 
*;  
 
*;  
*; </Configure></nowiki></pre>
+
*; </Configure></pre>

Revision as of 13:42, 21 July 2009


How to Deploy JIRA

These instructions have been tested against:

Jetty JIRA Servlet / JSP JVM Transaction Manager / DataSource
7.0.0.RC1 3.13.4 2.5 / 2.1 1.5 Atomikos 3.5.5 / HSQLDB 1.8.0.5

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>

Back to the top