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.
Difference between revisions of "Jetty/Howto/Deploy 3rd Party Products/JIRA"
< Jetty | Howto | Deploy 3rd Party Products
Line 16: | Line 16: | ||
=== Prepare the JIRA Web Application === | === Prepare the JIRA Web Application === | ||
Start from the JIRA Standalone Distribution, and: | Start from the JIRA Standalone Distribution, and: | ||
− | + | <ul> | |
− | + | <li>Copy <tt>$JIRA/common/lib/hsqldb-1.8.0.5.jar</tt> to <tt>$JETTY/lib/ext/hsqldb/hsqldb-1.8.0.5.jar</tt> (create the directories as needed)</li> | |
− | + | <li>Copy <tt>$JIRA/atlassian-jira</tt> to <tt>$JETTY/contexts-available/atlassian-jira</tt></li> | |
− | + | <li>Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/web.xml</tt>:</li> | |
− | + | <ul> | |
− | + | <li>add a <tt><resource-ref></tt> element for the datasource: | |
− | + | <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> | |
− | + | </li> | |
− | + | <li>if you want to use JavaMail Session, add a <tt><resource-ref></tt> for it too: | |
− | + | <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> | |
− | + | </li> | |
− | + | </ul> | |
− | + | <li>Modify <tt>$JETTY/contexts-available/atlassian-jira/WEB-INF/classes/entityengine.xml</tt>:</li> | |
− | + | <ul> | |
− | + | <li>modify the JNDI name for the user transaction from <tt>java:comp/env/UserTransaction</tt> to <tt>java:comp/UserTransaction</tt></li> | |
− | + | <li>make sure the JNDI name for the data source is <tt>java:comp/env/jdbc/JiraDS</tt></li> | |
− | + | </ul> | |
− | + | <li>Setup the transaction manager:</li> | |
− | + | <ul> | |
− | + | <li>unzip and copy [[Media:Jta.properties.zip|jta.properties]] to <tt>$JETTY/resources</tt></li> | |
− | + | <li>download [http://atomikos.com Atomikos TransactionEssentials] and copy:</li> | |
− | + | <ul> | |
− | + | <li><tt>$ATOMIKOS/dist/transactions-essentials-all.jar</tt> to <tt>$JETTY/lib/ext/atomikos/transactions-essentials-all.jar</tt> (create the directories as needed)</li> | |
− | + | <li><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)</li> | |
− | + | </ul> | |
− | + | </ul> | |
− | + | <li>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> | ||
+ | </li> | ||
+ | </ul> |
Revision as of 16:27, 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>