培訓文檔：JIRA
系統安裝與使用－－JIRA是基于J2EE的問題跟蹤管理系統，它正被廣泛的被開源軟件組織，以及全球著名的軟件公司使用，它堪稱是J2EE的Bugzilla。
JIRA 系統安裝與使用
目錄
1系統簡介
2系統安裝
2.1下載
2.2安裝與配置
2.2.1相關軟件
2.2.2JIRA安裝步驟
2.2.3Mysql數據庫安裝
3JIRA管理
3.1項目管理
3.2CVS模塊管理
3.3用戶管理
4JIRA 系統的使用
4.1提交任務單（報告bug）
4.1.1新建任務單
4.1.2填寫詳細資料
4.1.3添加附件、截圖
4.2任務單處理流程
4.2.1流程圖
4.2.2任務單的分配。
4.2.3開發人員處理
4.2.4測試與發布
4.2.5其他人的參與
5使用注意事項
?
JIRA是由www.atlassian.com開發的基于J2EE的問題跟蹤管理系統，它正被廣泛的被開源軟件組織，以及全球著名的軟件公司使用，它堪稱是J2EE的Bugzilla。
JIRA 開發商網址：http://www.atlassian.com/software/jira
JIRA 在線文檔：http://www.atlassian.com/software/jira/docs/v3.0/index.html?clicked=jirahelp
注冊登陸，選擇Enterprise Standalone 3.0系列版本下載，名字類似于下面的：
atlassian-jira-enterprise-3.0.3-standalone
JIRA幫助有完善的安裝文檔。
當前系統使用
JDK：sun jdk1.4
JIRA 系統（包含TOMCAT4.1）：atlassian-jira-enterprise-3.0.2-standalone.zip ；
Mysql數據庫：mysql-4.0.20d-win.zip ；
Mysql JDBC驅動：mysql-connector-java-3.0.14-production-bin.jar ；
注意：Mysql數據庫版本和JDBC驅動要選擇好版本，不然容易出現中文亂碼。
-
修改conf/server.xml 文件中的配置如下，尤其要注意URL。
<ResourceParams name="jdbc/JiraDS">
<parameter>
<name>driverClassName</name>
<value>com.mysql.jdbc.Driver</value>
</parameter>
<parameter>
<name>url</name><value>jdbc:mysql://localhost/jiradb?autoReconnect=true&useUnicode=true&characterEncoding=utf8</value>
</parameter>
<parameter>
<name>username</name>
<value>root</value>
</parameter>
<parameter>
<name>password</name>
<value></value>
</parameter>
<parameter>
<name>factory</name>
<value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
</parameter>
</ResourceParams>
-
修改atlassian-jira/WEB-INF/classes/entityengine.xml 文件，把數據庫類型改為mysql。
<datasource name="defaultDS" field-type-name="mysql"
-
復制數據庫驅動mysql-connector-java-3.0.14-production-bin.jar到 common\lib 目錄下面。
-
運行setup 目錄下SUNJVMinstallService.bat ，把TOMCAT添加為windows系統服務。注意適當修改相關參數。
默認安裝，建一個數據庫，名字為jiradb 。
運行Mysql4\bin 目錄下winmysqladmin.exe 啟動數據庫，啟動后自動會把mysql添加為windows服務。
用管理員身份登陸JIRA系統，然后選擇管理。
項目添加的幾個要素：
-
Name：項目名稱，如XX項目標準版
-
Key ：項目標識，在整個系統中唯一標識一個項目，只能是3個以上的字母。如項目的Key為：QXT
，那么這個項目下面所有的任務單將編號為 QXT-1,QXT2…… 等等
-
Lead Developer：項目負責人，這個人一般成為任務單默認的處理人。
-
其他的一般為默認
Global Setting（全局設定）下的CVS Modules
-
添加CVS
模塊
-
Name：模塊名稱。如 stand
-
CVS Root：如:pserver:admin @localhost:d:/cvswork
-
Module Name：項目在CVS的名稱
-
Log File Path：該模塊的臨時文件，一般放在C:\bugtracking\jira\
目錄下面。如設置為C:\bugtracking\jira\cvs-stand.log
-
為項目條件CVS
模塊
在管理項目詳細頁面中，在CVS Modules 條目中選擇一個已經定義了的CVS模塊。
為項目添加CVS模塊之后，我們可以在任務單中跟蹤每個任務單修改了那些文件。
JIRA 系統用戶默認有3種角色（用戶組）：
-
jira-users普通用戶
-
jira-developers開發人員，一般公司人員都設置為這個，可以被指派任務單，處理任務單，查看CVS等等權限。
-
jira-administrators管理員，可以增、刪、改項目和系統配置等等。
公司人員注冊后，須把他的用戶組改成jira-developers
注意：每個用戶組擁有什么樣的權限，可以用戶組的Permission Scheme 。
點擊新建任務單，選擇項目和任務單類型
任務單類型分為四種：
-
錯誤(Bug)
：產品中的錯誤，生產環境使用中和測試報告的。
-
新功能
：新功能，新需求
-
任務
：上級安排的任務，規劃
-
功能完善：原有功能不完善，不夠好用而進行的修改
-
摘要：盡量簡短地描述故障
-
優先級:分為危急嚴重一般次要輕微5個級別
-
組件: 選擇項目種對應的組件
-
受影響版本:當前出問題的版本
-
解決版本: 規劃要解決的版本，一般為出問題的版本
-
分配給：選擇分配給特定的人，如果不指定，則分選自動。
-
環境:例如操作系統，軟件信息，硬件規格（包括適用于本任務單的）等等信息。一般地，我們在這里添上聯系人，聯系方式等信息。
-
描述:詳細描述，越詳細越好。。。。。提供需要什么時候完成等等信息。最后能夠附上出問題的URL地址，以方便追查故障。
?
添加完成之后我們可以給任務單添加附件和截圖。
進入項目中的任務單列表，選擇剛剛添加的任務單，左邊操作有添加附件和添加截圖，可以把相關日志，截圖添加給任務單：
任務單處理流程、狀態變更和各角色參與見下圖。
-
任務單在新建的時候，可以分配給某個開發/維護人員處理。
-
系統管理員可以修改任務單，把它分配給某個開發/維護人員處理。
-
開發/維護人員可以自己申請把一個狀態為開放（OPEN）的任務單分配給自己。
任務單分配給一個開發/維護人員，那么這個開發人員就必須按任務等級開始處理任務單。
-
點擊Start Progress（開始處理）開始處理任務單，任務單的狀態則變為處理中（in progress）。
-
當處理完畢之后，點擊Resolve Issue （解決任務單），并填寫相關處理信息。任務單狀態則變為Resolve（已解決）。
注意：
開發人員提交源代碼的時候，請在CVS
注釋里添上任務單號，則JIRA
系統回自動跟蹤任務單修改了多少處源代碼。
圖1：Eclipse CVS提交時候添加注釋。
注意：
單號之間的中橫線不能用中文的“
－
”而應該用英文的
“-
”
圖2：JIRA系統與CVS配合的效果
TEST-3有一條中橫線代碼本任務單已經解決。
任務單提交者發現任務單狀態變為Resolve（已解決），那么他可以按照開發人員的指示對平臺進行測試并更新。
測試更新成功則關閉任務單Close Issue，并反饋信息到任務單中（添加注釋）
如果測試更新還發現有問題，則把任務單Reopen（重開放），提供信息指定開發人員再進行處理。
其他開發人員和管理員可以對任務單添加注釋，提供幫助和指示給當前處理的開發人員。
-
在填寫單內容、注釋的時候，避免使用中文雙引號“和”，內容含中文雙引號提交后極有可能變成一串無法辨認的引號，如：””””””””””
。但是英文雙引號“和”沒有問題。