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       <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-       check-on-start="tr"
         use-foreign-keys="false"
         use-foreign-key-indices="false"
         check-fks-on-start="false"
         check-fk-indices-on-start="false"
         add-missing-on-start="tr"
         check-indices-on-start="tr">
           <jndi-jdbc jndi-server-name="default" jndi-name="java:comp/env/jdbc/JiraDS"/>
7.      修改完entityengine.xml文件的上述兩個地方后，執(zhí)行加壓縮目錄下的build加壓縮目錄下的build.bat將默認地生成JIRA的war包
8.      下載mysql-connector-java-3.1.12-bin.jar拷貝到Tomcat安裝目錄的\common\lib下，請?zhí)貏e注意版本號必須為3.1.12
9.      從Atlassian下載jira-jars-tomcat5.zip拷貝到Tomcat安裝目錄的\common\lib下

useBodyEncodingForURI="tr"

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

 <!-- NOTE: If NOT using hsqldb, delete the next two parameters -->
    <!-- Give unused connections 4 secs before eviction. -->
    <parameter>
      <name>minEvictableIdleTimeMillis</name>
      <val>4000</val>
    </parameter>
    <!-- Check for evictions every 5 secs. -->
    <parameter>
      <name>timeBetweenEvictionRunsMillis</name>
      <val>5000</val>
    </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./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 -->
         <val>com.mysql.jdbc.Driver</val>
       </parameter>
       <parameter>
         <name>url</name>
         <val>jdbc:mysql://localhost/jiradb?autoReconnect=tr&useUnicode=tr&characterEncoding=UTF8&mysqlEncoding=utf8</val>
       </parameter>
       <parameter>
         <name>username</name>
         <val>jirauser</val>
       </parameter>
       <parameter>
         <name>password</name>
         <val>mypassword</val>
       </parameter>
        <parameter>
         <name>factory</name>
         <val>org.apache.commons.dbcp.BasicDataSourceFactory</val>
       </parameter>
 </ResourceParams>

     <Resource name="UserTransaction" auth="Container" type="javax.transaction.UserTransaction"/>
     <ResourceParams name="UserTransaction">
       <parameter>
         <name>factory</name>
         <val>org.objectweb.jotm.UserTransactionFactory</val>
       </parameter>
       <parameter>
         <name>jotm.timeout</name>
         <val>60</val>
       </parameter>
     </ResourceParams>
</Context>
14. 啟動tomcat，敲入http://.../jira，應(yīng)該就能看到JIRA的配置向?qū)Я?br>

系統(tǒng)簡介

JIRA是由www.開發(fā)的基于J2EE的問題跟蹤管理系統(tǒng)，它正被廣泛的被開源軟件組織，以及全球著名的軟件公司使用，它堪稱是J2EE的Bugzilla。

系統(tǒng)安裝

下載

JIRA 開發(fā)商網(wǎng)址：http://www./software/jira

JIRA 在線文檔：http://www./software/jira/docs/v3.0/index.html?clicked=jirahelp

注冊登陸，選擇Enterprise Standalone 3.0系列版本下載，名字類似于下面的：

atlassian-jira-enterprise-3.0.3-standalone

安裝與配置

JIRA幫助有完善的安裝文檔。

相關(guān)軟件

當前系統(tǒng)使用

JDK：sun jdk1.4

JIRA 系統(tǒng)（包含TOMCAT4.1）：atlassian-jira-enterprise-3.0.2-standalone.zip ；

Mysql數(shù)據(jù)庫：mysql-4.0.20d-win.zip ；

Mysql JDBC驅(qū)動：mysql-connector-java-3.0.14-prod tion-bin.jar ；

注意：Mysql數(shù)據(jù)庫版本和JDBC驅(qū)動要選擇好版本，不然容易出現(xiàn)中文亂碼。

JIRA安裝步驟

• 下載回來的文件解壓縮的jira3目錄下面。

• 安裝JDK,并設(shè)置JAVA_HOME 環(huán)境變量。

• 修改conf/server.xml 文件中的配置如下，尤其要注意URL。

<ResourceParams name="jdbc/JiraDS">

<parameter>

<name>driverClassName</name>

<val>com.mysql.jdbc.Driver</val>

</parameter>

<parameter>

<name>url</name><val>jdbc:mysql://localhost/jiradb?autoReconnect=tr&useUnicode=tr&characterEncoding=utf8</val>

</parameter>

<parameter>

<name>username</name>

<val>root</val>

</parameter>

<parameter>

<name>password</name>

<val></val>

</parameter>

<parameter>

<name>factory</name>

<val>org.apache.commons.dbcp.BasicDataSourceFactory</val>

</parameter>

</ResourceParams>

• 修改atlassian-jira/WEB-INF/classes/entityengine.xml 文件，把數(shù)據(jù)庫類型改為mysql。

<datasource name="defaultDS" field-type-name="mysql"

• 復(fù)制數(shù)據(jù)庫驅(qū)動mysql-connector-java-3.0.14-prod tion-bin.jar到 common\lib 目錄下面。

• 運行setup 目錄下SUNJVMinstallService.bat ，把TOMCAT添加為windows系統(tǒng)服務(wù)。注意適當修改相關(guān)參數(shù)。

• 漢化請參考幫助文件。

Mysql數(shù)據(jù)庫安裝

默認安裝，建一個數(shù)據(jù)庫，名字為jiradb 。

運行Mysql4\bin 目錄下winmysqladmin.exe 啟動數(shù)據(jù)庫，啟動后自動會把mysql添加為windows服務(wù)。

JIRA管理

用管理員身份登陸JIRA系統(tǒng)，然后選擇管理。

項目管理

• 添加項目

項目添加的幾個要素：

• Name：項目名稱，如XX項目標準版
• Key ：項目標識，在整個系統(tǒng)中唯一標識一個項目，只能是3個以上的字母。如項目的Key為：QXT ，那么這個項目下面所有的任務(wù)單將編號為 QXT-1,QXT2…… 等等
• Lead Developer：項目負責人，這個人一般成為任務(wù)單默認的處理人。
• 其他的一般為默認

CVS模塊管理

Global Setting（全局設(shè)定）下的CVS Modules

• 添加CVS模塊
  • Name：模塊名稱。如 stand
  • CVS Root：如:pserver:admin @localhost:d:/cvswork
  • Module Name：項目在CVS的名稱
  • Log File Path：該模塊的臨時文件，一般放在C:\bugtracking\jira\ 目錄下面。如設(shè)置為C:\bugtracking\jira\cvs-stand.log
• 為項目條件CVS模塊

在管理項目詳細頁面中，在CVS Modules 條目中選擇一個已經(jīng)定義了的CVS模塊。

為項目添加CVS模塊之后，我們可以在任務(wù)單中跟蹤每個任務(wù)單修改了那些文件。

用戶管理

JIRA 系統(tǒng)用戶默認有3種角色（用戶組）：

• jira-users普通用戶
• jira-developers開發(fā)人員，一般公司人員都設(shè)置為這個，可以被指派任務(wù)單，處理任務(wù)單，查看CVS等等權(quán)限。
• jira-administrators管理員，可以增、刪、改項目和系統(tǒng)配置等等。

公司人員注冊后，須把他的用戶組改成jira-developers

注意：每個用戶組擁有什么樣的權(quán)限，可以用戶組的Permission Scheme 。

JIRA 系統(tǒng)的使用

提交任務(wù)單（報告bug）

新建任務(wù)單

點擊新建任務(wù)單，選擇項目和任務(wù)單類型

任務(wù)單類型分為四種：

• 錯誤(Bug) ：產(chǎn)品中的錯誤，生產(chǎn)環(huán)境使用中和測試報告的。
• 新功能：新功能，新需求
• 任務(wù)：上級安排的任務(wù)，規(guī)劃
• 功能完善：原有功能不完善，不夠好用而進行的修改

填寫詳細資料

• 摘要：盡量簡短地描述故障
• 優(yōu)先級:分為危急嚴重一般次要輕微5個級別
• 組件: 選擇項目種對應(yīng)的組件
• 受影響版本:當前出問題的版本
• 解決版本: 規(guī)劃要解決的版本，一般為出問題的版本
• 分配給：選擇分配給特定的人，如果不指定，則分選自動。
• 環(huán)境:例如操作系統(tǒng)，軟件信息，硬件規(guī)格（包括適用于本任務(wù)單的）等等信息。一般地，我們在這里添上聯(lián)系人，聯(lián)系方式等信息。
• 描述:詳細描述，越詳細越好。。。。。提供需要什么時候完成等等信息。最后能夠附上出問題的URL地址，以方便追查故障。

添加附件、截圖

添加完成之后我們可以給任務(wù)單添加附件和截圖。

進入項目中的任務(wù)單列表，選擇剛剛添加的任務(wù)單，左邊操作有添加附件和添加截圖，可以把相關(guān)日志，截圖添加給任務(wù)單：

任務(wù)單處理流程

流程圖

任務(wù)單處理流程、狀態(tài)變更和各角色參與見下圖。

任務(wù)單的分配。

• 任務(wù)單在新建的時候，可以分配給某個開發(fā)/維護人員處理。
• 系統(tǒng)管理員可以修改任務(wù)單，把它分配給某個開發(fā)/維護人員處理。
• 開發(fā)/維護人員可以自己申請把一個狀態(tài)為開放（OPEN）的任務(wù)單分配給自己。

開發(fā)人員處理

任務(wù)單分配給一個開發(fā)/維護人員，那么這個開發(fā)人員就必須按任務(wù)等級開始處理任務(wù)單。

• 點擊Start Progress（開始處理）開始處理任務(wù)單，任務(wù)單的狀態(tài)則變?yōu)樘幚碇校╥n progress）。

• 當處理完畢之后，點擊Resolve Iss （解決任務(wù)單），并填寫相關(guān)處理信息。任務(wù)單狀態(tài)則變?yōu)镽esolve（已解決）。

注意：開發(fā)人員提交源代碼的時候，請在CVS注釋里添上任務(wù)單號，則JIRA系統(tǒng)回自動跟蹤任務(wù)單修改了多少處源代碼。

圖1：Eclipse CVS提交時候添加注釋。

注意：單號之間的中橫線不能用中文的“－”而應(yīng)該用英文的“- ”

圖2：JIRA系統(tǒng)與CVS配合的效果

TEST-3有一條中橫線代碼本任務(wù)單已經(jīng)解決。

測試與發(fā)布

任務(wù)單提交者發(fā)現(xiàn)任務(wù)單狀態(tài)變?yōu)镽esolve（已解決），那么他可以按照開發(fā)人員的指示對平臺進行測試并更新。

測試更新成功則關(guān)閉任務(wù)單Close Iss，并反饋信息到任務(wù)單中（添加注釋）

如果測試更新還發(fā)現(xiàn)有問題，則把任務(wù)單Reopen（重開放），提供信息指定開發(fā)人員再進行處理。

其他人的參與

其他開發(fā)人員和管理員可以對任務(wù)單添加注釋，提供幫助和指示給當前處理的開發(fā)人員。

使用注意事項

• 在填寫單內(nèi)容、注釋的時候，避免使用中文雙引號“和”，內(nèi)容含中文雙引號提交后極有可能變成一串無法辨認的引號，如：”””””””””” 。但是英文雙引號“和”沒有問題。