昨天转载了Judy Shen的《使用JIRA搭建企业问题跟踪系统》，在这篇文章中Jude Shen着重讲解了JIRA的特性和常用的设置。但是对于安装却没有提及，在本人实际安装JIRA的过程中，出现了一些问题，虽然最终解决但是花费了本人一下午的时间。为了帮助大家顺利安装，今天本人把安装的过程重新梳理一遍，请特别留意红色字体的部分。

1.      安装JDK(JDK1.4.2以上)，配置JAVA_HOME，安装Mysql(本人使用的版本是5.0.19)，安装tomcat(5.0.28)
   
2.      下载JIRA: 本人下载的版本为----3.6 Enterprise EAR/WAR的Zip文件
3.       解压缩JIRA，编辑解压缩目录\edit-webapp\WEB-INF\classes\entityengine.xml文件，原文件定义使用hsql(红色字体为增加部分)：  
   
4.     <transaction-factory class="org.ofbiz.core.entity.transaction.JNDIFactory">
         <user-transaction-jndi jndi-server-name="default" jndi-name="java:comp/env/UserTransaction"/>
         <transaction-manager-jndi jndi-server-name="default" jndi-name="java:comp/env/UserTransaction"/>
       </transaction-factory>
5.     原来的field-type-name="hsql"，改为“mysql”
   
6.      <datasource name="defaultDS" field-type-name="mysql"
           helper-class="org.ofbiz.core.entity.GenericHelperDAO"
         check-on-start="true"
         use-foreign-keys="false"
         use-foreign-key-indices="false"
         check-fks-on-start="false"
         check-fk-indices-on-start="false"
         add-missing-on-start="true"
         check-indices-on-start="true">
           <jndi-jdbc jndi-server-name="default" jndi-name="java:comp/env/jdbc/JiraDS"/>
7.      修改完entityengine.xml文件的上述两个地方后，执行加压缩目录下的build加压缩目录下的build.bat将默认地生成JIRA的war包
8.      下载mysql-connector-java-3.1.12-bin.jar拷贝到Tomcat安装目录的\common\lib下，请特别注意版本号必须为3.1.12
9.      从Atlassian下载jira-jars-tomcat5.zip拷贝到Tomcat安装目录的\common\lib下

  10.    配置Tomcat安装目录conf/server.xml,增加 

useBodyEncodingForURI="true"

<Connector port="8080"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" redirectPort="8443" acceptCount="100"
    debug="0" connectionTimeout="20000"
    disableUploadTimeout="true" useBodyEncodingForURI="true"/>

  11.   创建数据库(我命名为jiradb,使用utf8编码)
  12.   创建数据库的使用用户(jirauser)
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,INDEX on
  jiradb.* TO 'jirauser'@'localhost' IDENTIFIED BY 'mypassword';
  13.  拷贝dist-tomcat目录下的war包拷贝到tomcat安装目录下的webapps/目录下，拷贝dist-tomcat/tomcat-5/jira.xml到tomcat安装目录下/conf/Catalina/localhost/ 并修改该该文件
       删除下列配置(适用于hsqldb)

 <!-- NOTE: If NOT using hsqldb, delete the next two parameters -->
    <!-- Give unused connections 4 secs before eviction. -->
    <parameter>
      <name>minEvictableIdleTimeMillis</name>
      <value>4000</value>
    </parameter>
    <!-- Check for evictions every 5 secs. -->
    <parameter>
      <name>timeBetweenEvictionRunsMillis</name>
      <value>5000</value>
    </parameter>
修改后的jira.xml文件如下：
<!--
A sample configuration file for Tomcat 4.1.x and 5.0
Customize the docBase attribute, drop in your $CATALINA_HOME/webapps/ (4.1.x) or
$CATALINA_HOME/conf/Catalina/localhost/ (5.0) directory and restart Tomcat.
Note the JOTM dependencies; you'll need to copy various jars to Tomcat's common/lib/ directory.
See http://www.atlassian.com/software/jira/docs/latest/servers/tomcat41.html for details.
-->
 
<Context path="/jira" docBase="C:\usr\Apache\Tomcat5\webapps\jira" debug="0">
  <Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"/>
  <ResourceParams name="jdbc/JiraDS">
    <parameter>
      <name>driverClassName</name>
        <!-- NOTE: if you change the database type, you will need to change it in WEB-INF/classes/entityengine.xml -->
      <value>com.mysql.jdbc.Driver</value>
    </parameter>
    <parameter>
      <name>url</name>
      <value>jdbc:mysql://localhost/jiradb?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8&amp;mysqlEncoding=utf8</value>
    </parameter>
    <parameter>
      <name>username</name>
      <value>jirauser</value>
    </parameter>
    <parameter>
      <name>password</name>
      <value>mypassword</value>
    </parameter>
     <parameter>
      <name>factory</name>
      <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
    </parameter>
 </ResourceParams>

  <Resource name="UserTransaction" auth="Container" type="javax.transaction.UserTransaction"/>
  <ResourceParams name="UserTransaction">
    <parameter>
      <name>factory</name>
      <value>org.objectweb.jotm.UserTransactionFactory</value>
    </parameter>
    <parameter>
      <name>jotm.timeout</name>
      <value>60</value>
    </parameter>
  </ResourceParams>
</Context>
14. 启动tomcat，敲入http://.../jira，应该就能看到JIRA的配置向导了
                  （全文完）