Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Jetty/Howto/Deploy 3rd Party Products/JIRA"
< Jetty | Howto | Deploy 3rd Party Products
Line 20: | Line 20: | ||
* 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><resource-ref></tt> element for the datasource: | ** add a <tt><resource-ref></tt> element for the datasource: | ||
− | **; <pre> | + | **; <pre><resource-ref> |
− | **; | + | **; <res-ref-name>jdbc/JiraDS</res-ref-name> |
− | **; | + | **; <res-type>javax.sql.DataSource</res-type> |
− | **; | + | **; <res-auth>SERVLET</res-auth> |
− | **; | + | **;</resource-ref></pre> |
** if you want to use JavaMail Session, add a <tt><resource-ref></tt> for it too: | ** if you want to use JavaMail Session, add a <tt><resource-ref></tt> for it too: | ||
− | **; <pre> | + | **; <pre><resource-ref> |
− | **; | + | **; <res-ref-name>mail/Session</res-ref-name> |
− | **; | + | **; <res-type>javax.mail.Session</res-type> |
− | **; | + | **; <res-auth>SERVLET</res-auth> |
− | **; | + | **; </resource-ref></pre> |
* Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/classes/entityengine.xml</tt>: | * Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/classes/entityengine.xml</tt>: | ||
** modify the JNDI name for the user transaction from <tt>java:comp/env/UserTransaction</tt> to <tt>java:comp/UserTransaction</tt> | ** modify the JNDI name for the user transaction from <tt>java:comp/env/UserTransaction</tt> to <tt>java:comp/UserTransaction</tt> |
Revision as of 13:21, 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>
-
- add a <resource-ref> element for the datasource:
- 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>
-