Difference between revisions of "JIRA"

From Briki
Jump to: navigation, search
(Configure a new JIRA war instance for mysql and tomcat)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Configure a new JIRA war instance for mysql and tomcat ==
 
== Configure a new JIRA war instance for mysql and tomcat ==
 +
Some more details here: http://confluence.atlassian.com/display/JIRA/Installing+JIRA+on+Tomcat+6.0. Note in the instructions below that you should only ever edit files in ''edit-webapp'' (not ''webapp'' since they will be overwritten).
 +
 +
=== Prepare Tomcat ===
 +
* Edit ''/etc/defaults/tomcat6'' and add:
 +
<pre>
 +
JAVA_OPTS="-Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true \
 +
          -Dmail.mime.decodeparameters=true -Xms128m -Xmx512m -XX:MaxPermSize=256m"
 +
</pre>
 +
* Either edit ''/etc/default/tomcat6'' and set '''TOMCAT6_SECURITY=no''' or go through the pain of getting the security policy all setup
 +
* Install libmysql-java and '''sudo ln -s /usr/share/java/mysql-connector-java-5.1.6.jar /usr/share/tomcat6/lib/'''
 +
* Login to mysql as root, and '''create database jira; grant all on jira.* to jira@localhost identified by 'jira';'''
 +
* Download ''http://www.atlassian.com/software/jira/docs/servers/jars/v1/jira-jars-tomcat6.zip'', extract, and copy extracted jars to ''/usr/share/tomcat6/lib/''
 +
* '''sudo mkdir /var/lib/jira; sudo chown tomcat6:tomcat6 /var/lib/jira'''
 +
 +
=== Create war ===
 
* Extract tar.gz file to /opt (eg. /opt/atlassian-jira-enterprise-4.0.1)
 
* Extract tar.gz file to /opt (eg. /opt/atlassian-jira-enterprise-4.0.1)
* Edit ''/opt/atlassian-jira-enterprise-4.0.1/webapp/WEB-INF/classes/entityengine.xml'' and change:
+
* Edit ''/opt/atlassian-jira-enterprise-4.0.1/edit-webapp/WEB-INF/classes/jira-application.properties'' and set '''jira.home=/var/lib/jira'''
 +
* Edit ''/opt/atlassian-jira-enterprise-4.0.1/edit-webapp/WEB-INF/classes/entityengine.xml'' and change:
 
<pre>
 
<pre>
 
     <datasource name="defaultDS" field-type-name="hsql"
 
     <datasource name="defaultDS" field-type-name="hsql"
Line 12: Line 28:
 
* From ''/opt/atlassian-jira-enterprise-4.0.1'', run '''sudo chmod u+x build.sh; sudo ./build.sh war'''
 
* From ''/opt/atlassian-jira-enterprise-4.0.1'', run '''sudo chmod u+x build.sh; sudo ./build.sh war'''
  
* '''sudo cp /opt/atlassian-jira-enterprise-4.0.1/etc/tomcat-6-jira.xml  /etc/tomcat6/Catalina/localhost/jira.xml'''
+
=== Create webapp descriptor ===
* Edit ''/etc/tomcat6/Catalina/localhost/jira.xml''
+
* Edit ''/opt/atlassian-jira-enterprise-4.0.1/etc/tomcat-6-jira.xml''
 
** Set ''@JIRA_WEBAPP@'' = /opt/atlassian-jira-enterprise-4.0.1/dist-tomcat/atlassian-jira-4.0.1.war
 
** Set ''@JIRA_WEBAPP@'' = /opt/atlassian-jira-enterprise-4.0.1/dist-tomcat/atlassian-jira-4.0.1.war
 
** Delete the resource named ''jdbc/JiraDS'', and replace with:
 
** Delete the resource named ''jdbc/JiraDS'', and replace with:
Line 21: Line 37:
 
           password="jira"
 
           password="jira"
 
           driverClassName="com.mysql.jdbc.Driver"
 
           driverClassName="com.mysql.jdbc.Driver"
           url="jdbc:mysql://localhost/jira?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"/>
+
           url="jdbc:mysql://localhost/jira?autoReconnect=true&amp;amp;useUnicode=true&amp;amp;characterEncoding=UTF8"/>
 
</pre>
 
</pre>
* Either edit ''/etc/default/tomcat6'' and set '''TOMCAT6_SECURITY=no''' or go through the pain of getting the security policy all setup
+
* '''sudo ln -s /opt/atlassian-jira-enterprise-4.0.1/etc/tomcat-6-jira.xml  /etc/tomcat6/Catalina/localhost/jira.xml'''
* Install libmysql-java and '''sudo ln -s /usr/share/java/mysql-connector-java-5.1.6.jar /usr/share/tomcat6/lib/'''
+
 
* Login to mysql as root, and '''create database jira; grant all on jira.* to jira@localhost identified by 'jira';'''
 
* Download ''http://www.atlassian.com/software/jira/docs/servers/jars/v1/jira-jars-tomcat6.zip'', extract, and copy extracted jars to ''/usr/share/tomcat6/lib/''
 
 
* Restart tomcat and cross your fingers
 
* Restart tomcat and cross your fingers
 +
 +
== Configure a file/email watcher ==
 +
See: http://confluence.atlassian.com/display/JIRA/Creating+Issues+and+Comments+from+Email and http://confluence.atlassian.com/display/JIRA/Services#Services-BuiltinServices

Latest revision as of 14:35, 8 February 2010

Configure a new JIRA war instance for mysql and tomcat

Some more details here: http://confluence.atlassian.com/display/JIRA/Installing+JIRA+on+Tomcat+6.0. Note in the instructions below that you should only ever edit files in edit-webapp (not webapp since they will be overwritten).

Prepare Tomcat

  • Edit /etc/defaults/tomcat6 and add:
JAVA_OPTS="-Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true \
           -Dmail.mime.decodeparameters=true -Xms128m -Xmx512m -XX:MaxPermSize=256m"
  • Either edit /etc/default/tomcat6 and set TOMCAT6_SECURITY=no or go through the pain of getting the security policy all setup
  • Install libmysql-java and sudo ln -s /usr/share/java/mysql-connector-java-5.1.6.jar /usr/share/tomcat6/lib/
  • Login to mysql as root, and create database jira; grant all on jira.* to jira@localhost identified by 'jira';
  • Download http://www.atlassian.com/software/jira/docs/servers/jars/v1/jira-jars-tomcat6.zip, extract, and copy extracted jars to /usr/share/tomcat6/lib/
  • sudo mkdir /var/lib/jira; sudo chown tomcat6:tomcat6 /var/lib/jira

Create war

  • Extract tar.gz file to /opt (eg. /opt/atlassian-jira-enterprise-4.0.1)
  • Edit /opt/atlassian-jira-enterprise-4.0.1/edit-webapp/WEB-INF/classes/jira-application.properties and set jira.home=/var/lib/jira
  • Edit /opt/atlassian-jira-enterprise-4.0.1/edit-webapp/WEB-INF/classes/entityengine.xml and change:
    <datasource name="defaultDS" field-type-name="hsql"
       schema-name="PUBLIC"

to

    <datasource name="defaultDS" field-type-name="mysql"
  • From /opt/atlassian-jira-enterprise-4.0.1, run sudo chmod u+x build.sh; sudo ./build.sh war

Create webapp descriptor

  • Edit /opt/atlassian-jira-enterprise-4.0.1/etc/tomcat-6-jira.xml
    • Set @JIRA_WEBAPP@ = /opt/atlassian-jira-enterprise-4.0.1/dist-tomcat/atlassian-jira-4.0.1.war
    • Delete the resource named jdbc/JiraDS, and replace with:
<Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"
          username="jira"
          password="jira"
          driverClassName="com.mysql.jdbc.Driver"
          url="jdbc:mysql://localhost/jira?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"/>
  • sudo ln -s /opt/atlassian-jira-enterprise-4.0.1/etc/tomcat-6-jira.xml /etc/tomcat6/Catalina/localhost/jira.xml
  • Restart tomcat and cross your fingers

Configure a file/email watcher

See: http://confluence.atlassian.com/display/JIRA/Creating+Issues+and+Comments+from+Email and http://confluence.atlassian.com/display/JIRA/Services#Services-BuiltinServices