1.什麼是JIRA
JIRA是目前比較流行的基于Java架構的管理系統,由于Atlassian公司對很多開源項目實行免費提供缺陷跟蹤服務,是以在開源領域,其認知度比其他的産品要高得多,而且易用性也好一些。同時,開源則是其另一特色,在使用者購買其軟體的同時,也就将源代碼也購置進來,友善做二次開發。JIRA功能全面,界面友好,安裝簡單,配置靈活,權限管理以及可擴充性方面都十分出色。
2.JIRA的主要功能
● 問題追蹤和管理:用它管理項目,跟蹤任務、bug、需求,通過jira的郵件通知功能進行協作通知,在實際工作中使工作效率提高很多
● 問題跟進情況的分析報告:可以随時了解問題和項目的進展情況
● 項目類别管理功能:可以将相關的項目分組管理
● 元件/子產品負責人功能:可以将項目的不同元件/子產品指派相應的負責人,來處理所負責的元件的Issues
● 項目email位址功能:每個項目可以有不同的email(該項目的通知郵件從該位址發出)
● 無限制的工作流:可以建立多個工作流為不同的項目使用
3.JIRA的安裝
3.1.JIRA相關資料庫安裝(MySQL)
1、 安裝.net framework
2、 安裝Mysql
3、 建立資料庫jiradb,選擇語言UTF-8
注意:不可更新
3.2.JIRA安裝方法
1、點選Next
2、選擇端口:預設8080,本次安裝8091
3、 配置資料庫mysql
配置路徑:C:\Program Files\Atlassian\Application Data\JIRA下的dbconfig.xml
4、運作jira web
3.3.JIRA 破解
1、 運作注冊機:keygen.bat
或者:java –jar jira_keygen.jar
注意:要求jdk在1.6以上
輸入name 和server ID:
ServerID 為安裝頁面顯示的
2、 點選.patch
把jiar4.2.1-crack的atlassian-extras-2.2.jar導入,
3、 stop jira
4、 拷貝注冊機目錄的atlassian-extras-2.2.jar到jira的工程目錄:D:\Program Files\Atlassian\JIRA\atlassian-jira\WEB-INF\lib 替換原 atlassian-extras-2.2.jar
5、 點選.gen獲得授權碼
6、 啟動jira
7、 登入jira
3.4.JIRA中文插件安裝
1. 停止JIRA服務
2. 下載下傳插件檔案 jira-lang-zh_CN-4.4.jar,将插件複制到JIRA安裝路徑下 WEB-INF/lib
i. 将檔案名稱修改為 jira-lang-zh_CN-JIRA版本号.jar。
ii. 如果你使用的是JIRA4.4.1, 就将檔案名修改為jira-lang-zh_CN-4.4.1.jar
3. JIRA 系統插件中文檔案:
i. 下載下傳并解壓 atlassian-bundled-plugins_4.4.zip
ii.用winRAR打開 WEB-INF/classes/atlassian-bundled-plugins.zip
iii.将附件中的中文檔案加入至 WEB-INF/classes/atlassian-bundled-plugins.zip 對應的.jar包中對應的檔案夾中。 儲存并推出winRAR
4. 重新啟動JIRA服務
3.5.JIRA與SVN內建
1. 下載下傳目前svn插件:
A.方式一:通路管理者界面:插件
搜尋subversion:如下圖下載下傳
B. 方式二:http://repository.atlassian.com/atlassian-jira-subversion-plugin/distributions/ 選擇對應版本下載下傳
2. Svn插件內建:(atlassian-jira-subversion-plugin-0.10.7-distribution)
A.将atlassian-jira-subversion-plugin-0.10.7-distribution 下的Lib下所有jar包拷貝到jira的web-inf下的lib(D:\Program Files\Atlassian\JIRA\atlassian-jira\WEB-INF\lib)
B.修改atlassian-jira-subversion-plugin-0.10.7-distribution下的屬性檔案:subversion-jira-plugin.properties:
C.将subversion-jira-plugin.properties拷貝到如下檔案:D:\Program Files\Atlassian\JIRA\atlassian-jira\WEB-INF\classes
D.修改subversion-jira-plugin.properties檔案:内容如下
svn.root=http://10.1.1.237:8090/svn/svndemo
svn.display.name=Sample Repository
svn.username=test
svn.password=test
#多SVN工程目錄需要配置多個目錄
svn.root.1=http://10.1.1.237:8090/svn/svndemo1
svn.display.name.1=Sample Repository1
svn.username.1=test
svn.password..1=test
注意:存在多個svn的project時,需要在此配置多個svn的project目錄,且在jira的subversion的配置頁面,也許配置多個服務
E.重新開機jira,檢視如下圖:系統-進階配置-服務
3.6.JIRA與SVNWebClient
1. 下載下傳并安裝SVNWebClient:svnwebclient-3.1.0.zip
A.解壓svnwebclient-3.1.0.zip,下載下傳位址如下:http://www.polarion.com/products/svn/svn_webclient.php
B.拷貝\svnwebclient-3.1.0檔案下的svnwebclient.war到JIRA的Webapp目錄下D:\Program Files\Atlassian\JIRA\webapps
C.監測是否成功:浏覽器輸入http://localhost:8091/svnwebclient/
單svn工程目錄如下:
多svn工程目錄如下:
2. SVN高亮顯示插件安裝:
下載下傳安裝配置EnScript,位址為:http://gnuwin32.sourceforge.net/packages/enscript.htm
A.解壓enscript-1.6.3-9-bin.zip,将其複制到某目錄D:\Program Files\Atlassian
B.配置svnwebclient的web.xml,目錄位址如下:D:\Program Files\Atlassian\JIRA\webapps\svnwebclient\WEB-INF
添加enscript的配置
<context-param>
<param-name>EnscriptPath</param-name>
<param-value>
D:\Program Files\Atlassian\enscript-1.6.3-9-bin\bin\enscript.exe
</param-value>
</context-param>
修改svn的配置
<!—單工程目錄->
<context-param>
<param-name>RepositoryUrl</param-name>
<param-value>http://localhost:8090/svn/svndemo</param-value>
</context-param>
<!—多工程目錄->
<context-param>
<param-name>ParentRepositoryDirectory</param-name>
<param-value>http://10.1.1.237:8090/svn/</param-value>
</context-param>
修改SVN的使用者名和密碼
<context-param>
<param-name>Username</param-name>
<param-value>test</param-value>
</context-param>
<context-param>
<param-name>Password</param-name>
<param-value>test</param-value>
</context-param>
修改SVNWebClient的字元集
<context-param>
<param-name>DefaultEncoding</param-name>
<param-value>UTF-8</param-value>
</context-param>
<context-param>
<param-name>ZipEncoding</param-name>
<param-value>UTF-8</param-value>
</context-param>
對于部分SVN的中文注釋送出亂碼的情況配置:加入GBK
<context-param>
<param-name>CharacterEncodings</param-name>
<param-value>
windows-1250,windows-1251,windows-1252,windows-1253,windows-1254,
windows-1255,windows-1256,windows-1257,windows-1258,windows-31j,
UTF-8,UTF-16LE,UTF-16BE,UTF-16,
ISO-8859-1,ISO-8859-13,ISO-8859-15,ISO-8859-2,ISO-8859-3,ISO-8859-4,ISO-8859-5,ISO-8859-6,
ISO-8859-7,ISO-8859-8,ISO-8859-9,GBK,
US-ASCII,KOI8-R
</param-value>
</context-param>
C.配置jira自帶的TOMCat,修改conf/Server.xml (目錄如下)D:\Program Files\Atlassian\JIRA\conf
配置如下:
<Service name="Catalina">
<Connector port="8091"
URIEncoding="UTF-8"
maxThreads="150"
maxHttpHeaderSize="8192"
minSpareThreads="25"
maxSpareThreads="75"
useBodyEncodingForURI="false"
enableLookups="false"
protocol="HTTP/1.1"
redirectPort="8443"
acceptCount="100"
connectionTimeout="20000"
disableUploadTimeout="true" />
3. Jira中配置SVN插件:
A. 管理者登入JIRA系統界面
B.選擇Subversion Repositories,點選編輯或增加
C.修改其配置檔案
D. 更新儲存
4. 修複高亮顯示的問題 :
将安裝目錄下的jhighlight-1.0.jar替換D:\Programe Files\Atlassian\JIRA\webapps\svnwebclient\WEB-INF\lib下的jhighlight-1.0.jar
如下圖:SVN亂碼時可選擇GBK
3.7.JIRA與SVN使用方法
方法一:
1. 建立一個問題
2. 利用SVN用戶端送出代碼或文檔關聯問題或任務(TortoiseSVN)
Message填寫問題的KEY(TEST-2)
注釋:如果沒有實時更新,修改其更新時間
3. SVN權限控制
點選Default Permission Scheme
方法二:在SVN端對項目添加屬性檔案的方式
進入本地下載下傳的SVN庫中,利用TortoiseSVN用戶端中選擇TortoiseSVN—>Properties,
修改屬性内容:
修改之後送出内容,在Jira Issue輸入框中填寫所送出内容對于JIRA中的問題的編号,在Message中輸入相應的備注資訊,點選OK:
然後在JIRA中即可檢視到相應的版本内容:
3.8.JIRA與Eclipse使用方法
1. Eclipse中JIRA插件的安裝
點選添加,輸入URL:http://update.atlassian.com/atlassian-eclipse-plugin/3.0.0/e3.5
2. Eclipse中使用JIRA插件說明:
首先添加倉庫:
然後建立查詢:
最後任務清單:
3.9.常見問題
1. SVN權限控制:本地通路成功,遠端通路不成功
修改系統管理者界面的通用設定,及關閉相關防火牆
2. 登入webclient報錯
javax.servlet.ServletException: org.polarion.svnwebclient.SVNWebClientException: org.polarion.svnwebclient.data.DataProviderException: org.polarion.svnwebclient.data.javasvn.SVNRepositoryPool must be initialized before first usage
at org.apache.jasper.runtime.PageContextImpl.doHandlePageException(PageContextImpl.java:865)
at org.apache.jasper.runtime.PageContextImpl.handlePageException(PageContextImpl.java:794)
at org.apache.jsp.directoryContent_jsp._jspService(directoryContent_jsp.java:503)
at org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:70)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:717)
at org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:386)
解決方法:
Web.xml
<context-param>
<param-name>ParentRepositoryDirectory</param-name>
<!--param-value>http://svn.polarion.org/repos/community</param-value-->
<param-value>http://10.1.1.237:8090/svn/</param-value>
</context-param>
subversion-jira-plugin.properties
svn.root=http://10.1.1.237:8090/svn/
注意:修改時候先stop jira服務,使得修改内容可以生效
3. SVN安裝問題:
A.Could not open the requested SVN filesystem,原因及解決方法:
SVNParentPath E:\svn_repository\project 或者
SVNParentPath E:\svn_repository\
将其改為SVNParentPath E:\svn_repository
B.在project目錄下建立new的檔案夾:svn import -m "new import" E:\new http://localhost:8090/svn/project
4. 內建後,定位SVN失敗,location失敗
修改jira 配置頁面的配置檔案,注意修改SVNwebClient的指向檔案:下文紅色注釋的地方:
http://10.1.1.237:8091/svnwebclient/changedResource.jsp?location=svndemo1/&url=${path}&rev=${rev}&action=add
4.JIRA的相關配置
4.1.項目建立
1、項目建立
利用管理者權限登陸JIRA,進入管理者頁面,項目-添加-添加一個新的項目:
包括項目名稱及鍵值,及相應的項目負責人
其中項目鍵值為英文描述,項目建立人為預設的建立人(一般為項目經理)
2、項目類别劃分
點選類别:選擇項目所屬類别,根據建立項目的類别進行選擇。
目前公司的變更管理伺服器JIRA中的項目類别包含:None、測試、研發、維護四種。
4.2. 使用者角色的配置
4.2.1新增角色
利用管理者權限登陸JIRA,進入管理者頁面,選擇使用者—>角色,點選進入頁面
在“添加項目角色”子產品填寫名稱及描述,點選“添加項目角色”即可。
目前公司的變更管理伺服器JIRA中的項目角色包含:Administrator、Developers、Testers、Users四種角色。
4.2.2.新增使用者組
利用管理者權限登陸JIRA,進入管理者頁面,選擇使用者—>使用者組,點選進入頁面:
在下部的“添加使用者組”子產品填寫使用者組名稱,點選添加。
目前公司的變更管理伺服器JIRA中的使用者組包含:jira-administrators、jira-developers、jira-project managers、jira-testers、jira-users五種。
4.2.3.新增使用者
利用管理者權限登陸JIRA,進入管理者頁面,選擇使用者—>使用者,點選進入頁面
點選右側的“添加使用者”,輸入使用者名、密碼、确認密碼、全名、郵箱等資訊,點選建立。
4.3.全局權限的配置
利用管理者權限登陸JIRA,進入管理者界面,選擇使用者—全局權限,進入界面:
檢視到JIRA的權限包含:JIRA系統管理者、JIRA管理者、JIRA使用者、浏覽使用者、建立共享的對象、管理群組的過濾器訂閱、批量更改共七種權限。從這其中權限後面的“檢視使用者”連結可以檢視每個權限所對應的使用者。
若想添加新的權限,則在底部選擇相應的權限和使用者組,點選添加即可。若想删除某個權限,則點選删除即可直接删除。
當想要對某個使用者設定權限時,具有兩種方法:
方法一:可以通過在使用者—>使用者組界面中,将此使用者加入此權限的使用者組中。
方法二:通過在使用者—>使用者界面中,找到此使用者,點選後面的“編輯角色”,然後編輯項目角色,在相對應的項目下勾選想要賦予的權限,然後點選儲存。
4.4.權限方案的配置
權限方案是允許管理者先建立一系列權限控制,并将權限方案應用到任何項目中。
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—>權限方案,進入頁面:
通過點選底端的“添權重限方案”按鈕填寫所添權重限的名稱及描述即可填寫權限方案。再對項目設定權限方案時,點選建立的項目名稱進入頁面,在權限—>方案處即可修改。
4.5.問題類型方案的配置
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—>問題類型,進入頁面:
若想添加新的問題類型,則在底部的“添加新的問題類型”子產品填寫名稱、描述、類型、圖示URL等資訊,點選增加即可。
目前公司的變更管理伺服器JIRA中的問題類型包含:Bug、Improvement、New Feature、Task、TestCase、Sub-task、Sub-testcase七種,中文名稱分别為:缺陷、改進、新功能、任務、測試用例、子任務、子測試用例,其中前五種都是标準問題類型,後兩種是子任務問題類型。
4.6.問題屬性的配置
1. 問題狀态
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—問題屬性—狀态,進入頁面:
檢視到問題狀态包含:Open、In Progress、Reopened、Resolved、Closed五種,中文名稱分别為:打開、正在處理、重新打開、已解決、關閉。
若想添加新的問題狀态,則在底部填寫新狀态的名稱及描述,點選增加即可。
2. 問題解決結果
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—問題屬性—解決結果,進入頁面:
檢視到問題的解決結果包含:Fixed、Won’t Fix、Duplicate、Incomplete、Cannot Reproduce五種,中文名稱分别為:已解決、無需解決、問題重複、不完整、無法重制。
若想添加新的問題解決結果,隻需填寫名稱及描述,點選增加即可。
3. 問題優先級
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—問題屬性—優先級,進入頁面:
檢視到問題的屬性包含:Blocker、Critical、Major、Minor、Trivial五種,這五種屬性的中文名分别為:緊急、嚴重、一般、次要、無關緊要,優先級由高到低,優先級越高問題越嚴重越應最早解決。
若想添加新的屬性,隻需填寫名稱、描述、圖示URL、優先級顔色,點選增加即可。
4.7.工作流的配置
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—工作流,進入頁面:
檢視到工作流的狀态包含:已生效、草稿、未生效三種。每一種工作流都至少具有這三種狀态中的一個。
若想添加新的工作流,則在底部填寫新工作流的名稱、描述,點選增加即可,或者直接從XML檔案直接導入工作流。
若想删除一個工作流,則必須先從工作方案中将此工作流删除,然後才能在删除。
4.8.界面的配置
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—界面,進入界面:
界面是對字段的排列布局,是建立問題、編輯問題或執行工作流過程時顯示的頁面。公司變更管理伺服器JIRA中的界面主要包含:Default Screen、Resolved Issue Screen、Workflow Screen三種界面。
若添加新的界面則隻需填寫名稱及描述,點選增加即可。
4.9.字段的配置
利用管理者權限登陸JIRA,進入管理者頁面,選擇問題—字段,進入頁面:
公司的變更管理伺服器JIRA中的自定義字段包含:實際結果、期望結果、測試結果、輸入條件、預期結果五種。
若想添加新的字段,則點選“添加自定義字段”連結,在跳轉後的頁面中先選擇字段類型,然後填寫新增字段的項目明細資訊,點選完成即可。
5.JIRA的備份與恢複
5.1.JIRA的備份資料
JIRA中自帶資料備份,利用管理者權限登陸JIRA,進入管理者界面,在管理者界面中包含一個“備份資料”連結,進入之後輸入相應的檔案名,要求備份成XML檔案,可以指定檔案的具體存放位置,如果不指定則預設存放在C:\Windows\system32下,最後點選“備份”按鈕即可完成。
5.2.JIRA的恢複資料
JIRA中自帶對備份資料的恢複,利用管理者權限登陸JIRA,進入管理者頁面,在管理者頁面中包含一個“恢複資料”的連結,進入之後找到之前備份好的XML檔案,點選恢複即可恢複JIRA的備份資料。
5.3.JIRA的項目導入
若想要将JIRA的備份資料導入後成為一個新的項目,則可以利用管理者權限登陸JIRA,進入管理者頁面,在此頁面中包含“項目導入”連結,進入後直接找到備份檔案的路徑導入即可,但要求備份檔案和附件路徑必須在同一台JIRA執行個體伺服器中 。