培训文档：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（重开放），提供信息指定开发人员再进行处理。
其他开发人员和管理员可以对任务单添加注释，提供帮助和指示给当前处理的开发人员。
-
在填写单内容、注释的时候，避免使用中文双引号“和”，内容含中文双引号提交后极有可能变成一串无法辨认的引号，如：””””””””””
。但是英文双引号“和”没有问题。