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