JIRA产品使用说明书.docx

目录第一章JIRA简介21.1 什么是JIRA21.2 JIRA的主要功能21.3JIRA的主要特点31.3.1JIRA的优点31.3.2 JIRA的缺点31.4相关版本3第二章JIRA的安装和配置32.1安装准备42.2安装流程42.2.1jdk的安装和配置42.2.2MySQL的安装52.2.3JIRA的安装和配置62.3浏览器要求142.4操作系统要求152.5JIRA支持的服务152.6JIRA支持的数据库15第三章JIRA的基本概念153.1 JIRA 中涉及的角色153.1.1 管理人员153.1.2 项目管理者163.1.3 开发人员163.1.4 测试人员163.2 问题163.2.1问题类型163.2.2优先级（Priority Levels）173.2.3状态（Status）173.2.4解决（Resolutions）173.3项目173.3.1项目版本183.3.2项目组件183.4分配给183.5上传附件或屏幕截图183.6问题投票183.7件事问题18第四章 JIRA的使用184.1登录和注册194.2创建新项目204.3创建项目类别224.4添加新用户234.5添加组234.6创建问题244.7 浏览项目264.8查找问题27第五章 项目设置285.1添加项目285.2添加项目模块295.3添加项目版本295.4选择项目权限方案305.5设置项目的Default Assignee315.6选择邮件通知方案32第六章 JIRA系统的权限336.1全局权限336.2 系统缺省权限模型34第七章 附录和备注357.1技术支持367.2备注36 第一章JIRA简介1.1 什么是JIRA JIRA 是目前比较流行的基于Java架构的管理系统，由于Atlassian公司对很多开源项目实行免费提供缺陷跟踪服务，因此在开源领域，其认知度比其他的产品要高得多，而且易用性也好一些。同时，开源则是其另一特色，在用户购买其软件的同时，也就将源代码也购置进来，方便做二次开发。JIRA功能全面，界面友好，安装简单，配置灵活，权限管理以及可扩展性方面都十分出色。1.2 JIRA的主要功能 问题追踪和管理：用它管理项目，跟踪任务、bug、需求，通过jira的邮件通知功能进行协作通知，在实际工作中使工作效率提高很多 问题跟进情况的分析报告：可以随时了解问题和项目的进展情况 项目类别管理功能：可以将相关的项目分组管理 组件/模块负责人功能：可以将项目的不同组件/模块指派相应的负责人，来处理所负责的组件的Issues 项目email地址功能：每个项目可以有不同的email（该项目的通知邮件从该地址发出） 无限制的工作流：可以创建多个工作流为不同的项目使用1.3JIRA的主要特点1.3.1JIRA的优点用它管理项目，跟踪任务、bug，通过JIRA的邮件通知功能进行协作通知，在实际工作中使工作效率提高很多，效果非常不错！安全性、可扩展性方面发挥到了极致！JIRA不仅仅是一个缺陷跟踪系统，通过Jira，可以整合客户、开发人员、测试人员，各人各司其职，信息很快得到交流和反馈，让大家感到软件开发在顺利快速的进行，朝意想的目标迈进。eclipse和IDEA下的Jira插件，主要为开发人员服务，实时将信息反馈给开发人员，开发人员同时迅速地将修复的结果信息反馈到跟踪系统中，最后通过持续集成，软件迅速地完成了更新，这些方便便捷的操作会极大地鼓舞软件开发中的各方人员，甚至包括客户，及时响应，相信是每一个客户都会欣赏的。跟同类软件产品TestTracker、ClearQuest、TestDirector相比，JIRA的性价比最好！1.3.2 JIRA的缺点对于测试需求、测试用例等都没有提供直接的方式进行管理。不过可以利用JIRA的Issue Type的可定制性,来进行需求和测试用例方面的管理,也可以与Testlink集成。1.4相关版本JIRA 4.0版本之后，不再按照功能区分版本。取消了以前的标准版，专业版，企业版之分；取而代之的是按照用户数量来划分：25、50、100、无限制用户。 所有的版本都具有之前企业版的功能！JIRA不限制创建项目数和Issue的数量，购买之后可以永久使用；并且一年内免费更新版本。 第二章JIRA的安装和配置*本手册基于windows+MySQL+tomcat+JIRA的平台环境*操作环境实例：Windows版本：windows7 ultimate（* 建议以administrator超级管理员身份登录方便一些文件的权限操作）JDK版本：jdk-6u10-rc2-bin-b32-windows-i586-p-12_sep_2008Mysql版本：mysql-essential-5.1.36-win32Tomcat版本：tomcat6.0JIRA版本：jira-enterprise-3.13.2-windows2.1安装准备下载JDK、Mysql、JIRA相关的版本，参见7.1附录2.2安装流程确认系统上是否安装了以上三个软件，以下下为没有安装以上任何软件的操作情况：2.2.1jdk的安装和配置默认安装jdk6.0到C:Program FilesJavajdk1.6.0_10 配置jdk的环境变量，新建JAVA_HOME= C:Program FilesJavajdk1.6.0_10 在PATH变量中添加：C:Program FilesJavajdk1.6.0_10bin 新建环境变量：CLASSPATH=.; 进入命令行窗口：cmdjava出现一下画面代表成功安装jdk：2.2.2MySQL的安装默认安装mysql到：C:Program FilesMySQL 输入MySQL登录的用户名：root密码:root(用户自定义)启动mysql : 开始-所有程序 -MySQL-MySQL server 5.1 -mysql command line Client-输入Passwordroot出现以上画面这MySQL安装成功。2.2.3JIRA的安装和配置*可以参考: /display/JIRA/Connecting+JIRA+to+MySQL 1、解压默认安装jira到：C:Program FilesJIRA-Enterprise-3.13.2 2、创建一个JIRA使用的数据库：mysqlcreate database jiradb character set utf8;3、到网上去获取MySQL的jdbc驱动文件包：mysql-connector-java-5.1.12-bin.jar参考网址：/downloads/connector/j/5.1.html 然后把下载下来的驱动包拷贝到：C:Program FilesJIRA-Enterprise-3.13.2commonlib 下面。4、关闭jira：单击安装根目录下的shutdown_bundled_jre 5、修改jira安装目录下的conf/server.xml文件 需要更改的属性如下：UsernamePassworddriverClassNameurl删除minEvictableIdleTimeMillis,timeBetweenEvictionRunsMillis这两个属性，其余属性不做任何的操作，修改或得结果如下： 6、修改jira安装目录下C:Program FilesJIRA-Enterprise-3.13.2atlassian-jiraWEB-INFclassesentityengine.xml文件，修改其中的field-type-name的属性为mysql，并删除schema-name属性，xml中部分修改后的结果如下：7、重启jira：根目录下单击startup_bundled_jre出现下面的画面则jira配置成功 8、安装jira,在浏览器中输入：http:/localhost:8080回车进入安装界面 然后根据浏览器界面上的JIRA配置向导，经过三个配置步骤就完成： 第一步就是配置JIRA系统的属性； 第二步是配置JIRA系统管理员的信息； 第三步是配置JIRA系统的邮件通知参数。第一步：在*标题输入您安装的JIRA系统的标题信息；在*模式下拉框中有两个选项：public和private。表示JIRA可以运行在两种模式下。Public模式在这种模式下用户可以自己注册到JIRA系统中，并可以创建问题；private模式表示安装的JIRA系统是私有的，不允许用户随意的注册，只能由JIRA系统管理员来创建用户、分配权限。*根地址，表示您安装的JIRA系统的访问地址，用户在浏览器中通过这个URL来访问；*索引路径，输入框中输入保存JIRA系统索引数据的目录，如：C：jiraindexEnable Backups ,选择“是”启用JIRA系统自动备份功能；“附件路径”输入框中输入保存与问题关联的附件文件的目录，如：d:jiraattachments“备份路径”输入框中保存JIRA备份文件的目录，如：d:jirabackups （JIRA提供路定期自动备份的功能，自动备份的文件就存在这个目录下。）“授权码”输入框中输入评估license，如果没有的话，可以在 安装界面上点击“在线”连接生成一个评估license，输入评估license后，点击“下一步”按钮开始第二步配置关于JIRA的破解:上面对话框最后要求用户输入一个License ，做到这里我们需要对JIRA进行破解。方法如下：笔者用MyEclipse5.5做了一个生成License的keygen.java生成文件（使用Eclipse也可以）首先新建一个Java project，然后点击fileBuilPath-configure Build Path-add extrnal Jars选择要加入的atlassian-extras-1.17.jar 目录为：C:ProgramFilesJIRA-Enterprise-3.13.2atlassian-jiraWEB-INFlibatlassian-extras-1.17.jar 成功引入jar包后，project下面会多了个jar包。其次是在该Java project下面见一个keygen.java类代码如下：import com.atlassian.license.LicensePair;import java.io.*; import java.security.KeyFactory; import java.security.Signature; import java.security.spec.PKCS8EncodedKeySpec; public class keygenpublic keygen()public static void main(String args)throws IOExceptiontrylong l = 267L; long l1 = System.currentTimeMillis(); long l2 = System.currentTimeMillis(); String s = ; System.out.println(Keygen for JIRA Enterprise Edition.); System.out.print(created by mydajROR.); doSystem.out.print(nEnter your organization name: ); for(int i = System.in.read(); i != 10 & i != 13; i = System.in.read()s = s + (char)i; while(s = ); tryPKCS8EncodedKeySpec pkcs8encodedkeyspec = new PKCS8EncodedKeySpec(EncodedPrvKey); KeyFactory keyfactory = KeyFactory.getInstance(DSA, SUN); java.security.PrivateKey privatekey = keyfactory.generatePrivate(pkcs8encodedkeyspec); String s1 = Long.toString(l, 10); s1 = s1 + ; s1 = s1 + Long.toString(l1, 10); s1 = s1 + ; s1 = s1 + Long.toString(l2, 10); s1 = s1 + ; s1 = s1 + s; byte abyte0 = s1.getBytes(); Signature signature = Signature.getInstance(SHA1withDSA); signature.initSign(privatekey); signature.update(abyte0); byte abyte1 = signature.sign(); LicensePair licensepair = null; trylicensepair = new LicensePair(abyte0, abyte1); catch(Exception exception1)exception1.printStackTrace(); System.out.println(s1); System.out.println(Your license key is: ); System.out.println(licensepair.toString(); catch(Exception exception)exception.printStackTrace(); catch(IOException ioexception) static byte EncodedPrvKey = 48, -126, 1, 75, 2, 1, 0, 48, -126, 1, 44, 6, 7, 42, -122, 72, -50, 56, 4, 1, 48, -126, 1, 31, 2, -127, -127, 0, -3, 127, 83, -127, 29, 117, 18, 41, 82, -33, 74, -100, 46, -20, -28, -25, -10, 17, -73, 82, 60, -17, 68, 0, -61, 30, 63, -128, -74, 81, 38, 105, 69, 93, 64, 34, 81, -5, 89, 61, -115, 88, -6, -65, -59, -11, -70, 48, -10, -53, -101, 85, 108, -41, -127, 59, -128, 29, 52, 111, -14, 102, 96, -73, 107, -103, 80, -91, -92, -97, -97, -24, 4, 123, 16, 34, -62, 79, -69, -87, -41, -2, -73, -58, 27, -8, 59, 87, -25, -58, -88, -90, 21, 15, 4, -5, -125, -10, -45, -59, 30, -61, 2, 53, 84, 19, 90, 22, -111, 50, -10, 117, -13, -82, 43, 97, -41, 42, -17, -14, 34, 3, 25, -99, -47, 72, 1, -57, 2, 21, 0, -105, 96, 80, -113, 21, 35, 11, -52, -78, -110, -71, -126, -94, -21, -124, 11, -16, 88, 28, -11, 2, -127, -127, 0, -9, -31, -96, -123, -42, -101, 61, -34, -53, -68, -85, 92, 54, -72, 87, -71, 121, -108, -81, -69, -6, 58, -22, -126, -7, 87, 76, 11, 61, 7, -126, 103, 81, 89, 87, -114, -70, -44, 89, 79, -26, 113, 7, 16, -127, -128, -76, 73, 22, 113, 35, -24, 76, 40, 22, 19, -73, -49, 9, 50, -116, -56, -90, -31, 60, 22, 122, -117, 84, 124, -115, 40, -32, -93, -82, 30, 43, -77, -90, 117, -111, 110, -93, 127, 11, -6, 33, 53, 98, -15, -5, 98, 122, 1, 36, 59, -52, -92, -15, -66, -88, 81, -112, -119, -88, -125, -33, -31, 90, -27, -97, 6, -110, -117, 102, 94, -128, 123, 85, 37, 100, 1, 76, 59, -2, -49, 73, 42, 4, 22, 2, 20, 42, 50, -88, 30, 125, -37, 118, -50, 20, -82, -63, 0, 8, -36, 106, -9, -110, 124, 107, 68; 完成之后，run这个java类，则在MyEclipse下面控制台有提示：Keygen for JIRA Enterprise Edition.created by mydajROR.Enter your organization name:输入任意字符，回车就可以生成一个新的License之后把这段license复制到jira安装过程的浏览器端点击“下一步”即出现：第二步：到此破解成功！填入相应的跟人信息点击“下一步”出现：第三步：这里也可以选择禁止邮件通知，然后提示：2.3浏览器要求JIRA支持各种主流的web浏览器，如：IE、Mozilla、Firefox、Opera、Safari等。2.4操作系统要求 JIRA的运行需要Java环境，Java是一个跨平台的编程语言，因此所有支持java的操作系统都可以运行JIRA，当然也需要考虑系统上是否支持您选择的应用服务软件。2.5JIRA支持的服务l OrionServerl Resinl Tomcatl JBossl Jettyl Oracle OC4Jl Weblogic2.6JIRA支持的数据库u Oracleu DB2u Mysqlu Firebirdu SQL Server 2000u SapDBu PostgreSQLu Sysbase第三章JIRA的基本概念3.1 JIRA 中涉及的角色JIRA 作为一个缺陷跟踪管理系统，可以被企业管理人员，项目管理人员，开发人员，分析人员，测试人员和其他人员所广泛使用。3.1.1 管理人员根据 JIRA 系统提供的数据，更加准确地了解项目的开发质量和状态，以及整个团队的工作效率。3.1.2 项目管理者可以针对登记进 JIRA 系统中问题，进行评估，分配缺陷；还可以通过 JIRA 系统的统计报告了解项目进展情况以及团队的工作量、工作效率等信息。3.1.3 开发人员在 JIRA 系统中查看分配给自己的问题，及时进行处理，填写处理情况并提交工作量记录。3.1.4 测试人员根据测试情况，在 JIRA 系统中及时快速的记录问题并对开发人员处理后的问题进行验证和跟踪。3.2 问题u JIRA 跟踪问题（Issue），这些问题可以是 bug，功能请求或者任何其他想要跟踪的的任务；每一个问题有一些关联的信息：u 问题类型（Issue Type）u 摘要（summary）u 问题描述（description）u 问题所属的项目u 问题关联的项目组件（component）u 问题影响的项目版本（affect version）u 问题将被解决的项目版本（resolved version）u 问题发生的环境u 问题的优先级u 问题的报告者u 问题的指派处理人u 问题的当前状态u 问题相关的历史记录3.2.1问题类型JIRA 系统可以用于跟踪多种不同类型的问题。系统管理员可以根据需要添加。JIRA系统缺省提供的问题类型如下： Bug ：测试过程、维护过程发现影响系统运行的缺陷 New Feature ：对系统提出的新功能 Task ：需要完成的任务 Improvement ：对现有系统功能的改进3.2.2优先级（Priority Levels）在 JIRA 系统中用优先级来表示问题的严重级别。系统管理员可以在 JIRA 系统中添加优先级，JIRA 系统缺省的优先级如下：级别参考描述Blocker 阻塞开发或测试的工作进度，或影响系统无法运行的错误Critical 系统崩溃，丢失数据或内存溢出等严重错误、或者必需完成的任务Major 主要的功能无效、新增功能建议Minor 功能部分无效或对现有系统的改进Trivial拼写错误，文本未对齐等3.2.3状态（Status）每个问题有一个状态，用来表明问题所处的阶段，问题通过开始于 open 状态，然后开始处理/Progress，再到解决/Resolved，然后被关闭/Closed。根据情况的不同，您可以根据项目来定制问题状态以及工作流。JIRA 系统提供的缺省状态如下： Open ：表示问题被提交等待有人处理。 In Progress ：问题在处理当中，尚未完成。 Resolved ：问题曾解决，但解决结论未获认可，需要重新分派解决。 Reopened ：问题解决，等待结果确认，确认的结果是“Reopened”或者“Closed”。 Closed ：问题处理结果确认后，置于关闭状态。3.2.4解决（Resolutions） 一个问题可以用多种方式解决，系统管理员是可以在 JIRA 系统中定制解决方式。JIRA系统默认的解决方式如下：l Fixed ：问题已经解决。l Wont Fix ：问题未解决 - 将不会解决的问题。l Duplicate ：重复的问题。l Incomplete ：问题描述得不够准确、完全。l Cannot Reproduce ：问题重现失败，或者无足够的信息重现问题。3.3项目一个 JIRA 系统通常包含许多项目。这些项目相当于产品或者开发项目，您想要跟踪和这些项目相关的问题。每一个问题属于一个项目。每一个项目有一个名字和一个关键字（如：WEB），以后属于这个项目的问题的关键字就会包含 WEB（如：WEB-100，WEB-101）。值得注意的是，在 JIRA 系统中有一个权限Administer Projects，通常将这个权限赋给项目负责人，拥有这个权限的 JIRA 用户就可以管理项目的版本和组件。3.3.1项目版本在一个项目上，一般会有多个版本，如：1.0alpha、1.0beta、1.0、1.2、2.0。JIRA 系统中的问题涉及到两个版本字段： 影响版本，如一个 bug 可能影响版本 1.1 和 1.2。 修复版本，如 bug 影响版本 1.1 和 1.2，可能在 2.0 版本上被解决。版本通常有三种状态：发布/released、未发布/unreleased 和归档/archived。版本还有发布日期，在特定的报告中会显示。在 JIRA 系统中可以为项目创建版本。3.3.2项目组件每一个项目通常会包含多个组件/模块，如：后台，GUI，邮件子系统等等。一个问题可以和组件关联起来。在 JIRA 系统中可以为项目添加组件。3.4分配给分配给/Assign To：把某个问题 Issue 指定给某个团队成员去解决。3.5上传附件或屏幕截图Attach file/Screenshot：附加文件或屏幕截图说明 issue。3.6问题投票投票/Voting：除了问题的创建人，其他人可以用投票来表明支持某个问题的内容；3.7件事问题Watching：每人都有一个 Watch List/监视列表，可以监视自己感兴趣的 Issue 的状态等。第四章 JIRA的使用4.1登录和注册在成功安装配置完成后的界面上点击“登录到 JIRA”,就会看到 JIRA 的登录界面了：输入系统管理员的用户名和密码就可以登录 JIRA 系统。当然也可以点击“注册”链接在 JIRA 系统中注册另外的用户帐号。JIRA 系统的注册帐号界面如下图： 输入系统管理员帐号信息后登录 JIRA 系统，界面如下图：4.2创建新项目 在刚刚配置完的 JIRA 系统中是没有任何项目的，通常开始使用 JIRA 首先是创建项目，在上面的界面上点击“现在创建一个项目”，在界面上输入项目的名称，关键字/Key，项目负责人，项目的描述信息，通知模型/Notification Scheme权限模型/Permission Scheme。最初使用的时候可以暂时不用管网址和 Issue Security 选项。Notification Scheme 和/Permission Scheme可以分别选择 JIRA 系统缺省的 Default Notification Scheme 和 Default Permission Scheme。添加新项目的界面如下图： 项目的信息填写完成后，点击“增加”按钮就会看到您在 JIRA 系统中创建的新项目的详细信息界面： 接下来，您可以在项目的详细信息界面上，为项目创建组件/模块（Components）,管理项目的版本。如要创建组件，可点击 Component 下方的“Add”链接，如要管理项目的版本（Versions），可点击 Versions 下面的“Manage”链接。注意：新项目创建完成后，项目的关键字/key（如：上面界面图中项目的 Key：KM）是不能修改的。如果您想要继续创建新项目，则可以点击左侧的“项目”链接，然后再点击“Add Project”链接。如下图： 4.3创建项目类别 在使用JIRA过程中，会有越来越多的项目被添加到JIRA系统中，这时候可以利用JIRA系统的项目类别功能（Project Categories），定义一些项目类别名称，然后将同类的项目归到一个类别里面，方便管理。在项目详细信息界面上可以找到 Project Category: 无 ( Select Category ) 点击“Select Category”链接，选择一个项目类别，这样就把该项目添加到所选择的项目类别里了。把项目添加到项目类别后，在 JIRA 系统的首页上可以看到的效果： 4.4添加新用户 在安装完 JIRA 系统后，系统中只有一个系统管理员帐号；在创建完项目后，通常需要在 JIRA 系统中添加其他的用户帐号，在管理界面上点击左侧的 Users&Groups-“User Browser”链接，在 User Browser 界面上再点击“Add User”链接就可以添加新用户了。注意：不要使用汉字作为用户名。如下图：4.5添加组JIRA 系统的用户是通过 Group 来管理的，通过给组的授权，达到管理用户的目的。添加组的步骤：在管理界面上点击左侧的 Users&Groups-“Group Browser”链接，在 Group Browser 界面右侧名称输入框中输入组名，然后点击“Add Group”按钮即可。注意：不要使用汉字作为组名。4.6创建问题创建问题第一个步骤是选择项目和问题类型，然后点击“下一步”填写问题的详细信息。 下图是创建问题的第二步，填写或选择创建的问题详细信息，主要包括：问题的概要描述、优先级、逾期日期、所属模块、问题影响的版本、问题修复的版本、分配给哪个人员、问题出现的环境描述、问题详细信息描述。问题创建完成后，分配到问题的用户将会收到通知邮件，登录 JIRA 系统后，在分配给我的问题列表中点击问题链接后，在问题的详细信息界面上就可以进行根据可选工作流程进行操作。问题详细信息界面图如下，从图中可以看出这个目前对这个问题可以进行的操作有三个：开始进行、解决问题和关闭问题。 问题创建后，您除了可安装可选工作流程对问题进行处理外，还可以给问题上传附件，填写备注，复制和编辑问题，如果有权限的话，还可以删除问题，创建子任务等。4.7 浏览项目 在浏览项目的界面上可以看到项目的基本信息资料，模块和版本信息及问题分布情况。如下图： 4.8查找问题在查找问题界面上，您可以在界面左侧进行查询条件的设置，JIRA 提供了强大的查询功能，在您设定好查询条件后，还可以将查询条件保存起来，定义为过滤器，供以后的重复使用，甚至可以将保存的过滤器共享给团队的其他成员。下图为”查找问题”的界面截图：第五章 项目设置5.1添加项目输入项目名称、项目缩写、项目经理，选择邮件通知方案和权限设置方案；参见 4.25.2添加项目模块 在项目的详细信息界面上，为项目创建组件/模块（Components）,管理项目的版本。如要创建组件，可点击 Components 下方的“Add”链接。界面图如下： 5.3添加项目版本设置步骤如下：在 Project 页面下的“ Versions ”部分，点击“ Manage ”Versions，进入管理版本界面，可以为项目添加版本、版本描述、设置发布日期。 5.4选择项目权限方案设置步骤如下：1) 点击“管理”“项目 ”，点击项目名称链查看项目详细信息界面；2) 在“ Permission Scheme ”部分，点击“ 选择 ”链接，在进入的页面中选择需要的权限设置方案。 5.5设置项目的Default Assignee系统默认是分配给项目负责人，即项目经理。可以根据需要选择默认为模块负责人。设置步骤如下：1) 在 Project 页面下的“ Components ”部分，在“ select assignees for components ”处，点击“ Select ”链接，进入“ Select Component Assignee ”界面2) 选择模块的默认分配人。 5.6选择邮件通知方案设置步骤如下：1) 选择“管理”“ Projects ”“ Projects ”，进入项目详细信息界面；2) 在“ Notification Scheme ”部分，点击“ select scheme ”链接，在进入的页面中选择需要的邮件通知方案。 第六章 JIRA系统的权限JIRA 系统中的权限管理分为：系统级别、项目级别、问题级别以及注释级别。系统级是通过”全局权限（Global Permissions）”来管理的，影响 JIRA 系统中所有的项目和问题。针对个别项目来说，您还可以通过 JIRA 系统中的权限模型（Permission Scheme）进一步配置项目级别的权限。下面将分别介绍全局权限和基于项目的权限模型。6.1全局权限设置步骤：1) 以 JIRA 系统管理员登录系统；2) 点击” Global Settings”-” Global Permissions”。界面如下图： 6.2 系统缺省权限模型如下表格是关于 JIRA 系