培训文档：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驱动要选择好版本，不然容易出现中文乱码。

JIRA安装步骤

• 下载回来的文件解压缩的jira3目录下面。

• 安装JDK,并设置JAVA_HOME 环境变量。

• 修改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&amp;useUnicode=true&amp;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系统服务。注意适当修改相关参数。

• 汉化请参考帮助文件。

Mysql数据库安装

默认安装，建一个数据库，名字为jiradb 。

运行Mysql4\bin 目录下winmysqladmin.exe 启动数据库，启动后自动会把mysql添加为windows服务。

JIRA管理

用管理员身份登陆JIRA系统，然后选择管理。

项目管理

• 添加项目

项目添加的几个要素：

• Name：项目名称，如XX项目标准版
• Key ：项目标识，在整个系统中唯一标识一个项目，只能是3个以上的字母。如项目的Key为：QXT ，那么这个项目下面所有的任务单将编号为 QXT-1,QXT2…… 等等
• Lead Developer：项目负责人，这个人一般成为任务单默认的处理人。
• 其他的一般为默认

CVS模块管理

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 。

JIRA 系统的使用

提交任务单（报告bug）

新建任务单

点击新建任务单，选择项目和任务单类型

任务单类型分为四种：

• 错误(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（重开放），提供信息指定开发人员再进行处理。

其他人的参与

其他开发人员和管理员可以对任务单添加注释，提供帮助和指示给当前处理的开发人员。

使用注意事项

• 在填写单内容、注释的时候，避免使用中文双引号“和”，内容含中文双引号提交后极有可能变成一串无法辨认的引号，如：”””””””””” 。但是英文双引号“和”没有问题。

• 待填写……