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 39: | Line 39: | ||
*** <tt>$ATOMIKOS/dist/transactions-essentials-all.jar</tt> to <tt>$JETTY/lib/ext/atomikos/transactions-essentials-all.jar</tt> (create the directories as needed) | *** <tt>$ATOMIKOS/dist/transactions-essentials-all.jar</tt> to <tt>$JETTY/lib/ext/atomikos/transactions-essentials-all.jar</tt> (create the directories as needed) | ||
*** <tt>$ATOMIKOS/lib/jta.jar</tt> to <tt>$JETTY/lib/ext/atomikos/jta.jar</tt> (or alternatively make sure the JTA classes are available to Jetty) | *** <tt>$ATOMIKOS/lib/jta.jar</tt> to <tt>$JETTY/lib/ext/atomikos/jta.jar</tt> (or alternatively make sure the JTA classes are available to Jetty) | ||
− | * | + | * Create the context file <tt>$JETTY/contexts/jira.xml</tt> and copy the following: |
+ | *; <pre><?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></pre> |
Revision as of 13:19, 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>
-