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 4: | Line 4: | ||
</css> | </css> | ||
− | == | + | {{Jetty Howto |
+ | |||
+ | == Introduction == | ||
These instructions have been tested against: | These instructions have been tested against: | ||
{| class="jetty-table" | {| class="jetty-table" |
Revision as of 02:03, 31 July 2009
{{Jetty Howto
Introduction
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 server-wide transaction manager Jetty configuration file $JETTY/etc/jetty-tm.xml with the following content:
<?xml version="1.0"?> <!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd"> <Configure id="Server" class="org.eclipse.jetty.server.Server"> <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> </Configure>
- Create the JIRA web application context configuration file $JETTY/contexts/jira.xml with the following content:
<?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"> <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>
Start Jetty
Start Jetty with the following command from the $JETTY directory:
java -jar start.jar OPTIONS=default,plus,jsp etc/jetty.xml etc/jetty-tm.xml