构建高效的团队协作工具(一) Jira安装配置

Jira是基于web的问题跟踪和项目管理软件解决方案,JIRA广泛地应用于全球上千家企业和开源组织.可以作为bug跟踪,缺陷跟踪,项目管理软件,JIRA使用简单,配置灵活,有完善的权限管理以及扩展性。

1. 系统环境

OS:	CentOS release 5.6
Jdk:	1.6.0_26
Web Server:	tomcat-6.0.32
DB:	MySQL Community Server 5.5.15
Jdbc	mysql-connector-java-5.1.17
Jira:	atlassian-jira-enterprise-4.2.1-b588(war)

系统环境配置在这里不进行描述，假设tomcat、mysql等环境配置完成。

2. 目录规划

/usr/local/jdk1.6	Jdk 安装目录，JAVA_HOME及CLASSPATH设置为全局环境变量
	mysql使用rpm默认安装路径
/opt/tomcat6	Tomcat安装目录
/opt/atlassian	Atlassian产品安装的父目录
/opt/atlassian/home	Atlassian产品主目录，jira_home是在/opt/atlassian/home/jira
/opt/atlassian/jira	Jira安装目录

3. 建立jira数据库

以root用户登录到mysql，创建jira所需的schema

mysql> create database jira character set utf8;

mysql> grant all on jira.* to jira@'localhost' identified by'jira';
4. 生成jira工程

下载JIRA4.2.1 Enterprise - WAR/EAR（选择WAR版本主要是觉得可灵活配置），解压到一临时目录（例如：/opt/resource）。

切换到解压后的目录中，运行build.sh:

$ sh build.sh

运行之后生成相应的目录及文件，进入到dist-tomcat/tomcat-6/目录下，把atlassian-jira-4.2.1-b588.war文件解压到/opt/atlassian/jira目录下。

复制dist-tomcat/tomcat-6/jira.xml文件到Tomcat的conf/Catalina/localhost/目录下（如果没有该目录则创建或运行一次tomcat生成）。
5. 更新Tomcat类包

Tomcat没有附带一些JIRA运行所需的类包：

carol-1.5.2.jar

carol-properties.jar

commons-logging-1.0.4.jar

hsqldb-1.8.0.5.jar

jonas_timer-1.4.3.jar

jotm-1.4.3.jar

jotm-iiop_stubs-1.4.3.jar

jotm-jrmp_stubs-1.4.3.jar

jta-1.0.1.jar

log4j-1.2.15.jar

objectweb-datasource-1.4.3.jar

ots-jts_1.0.jar

xapool-1.3.1.jar

从这里下载 jira-jars-tomcat6.zip (1.5Mb),解压并复制其中包含的jar文件到Tomcat的 lib/ 目录.

所需javamail类包，mail.jar下载地址

http://www.oracle.com/technetwork/java/index-138643.html

activation.jar（即JAF）下载地址

http://www.oracle.com/technetwork/java/index-135046.html

下载完解压后把mail.jar、activation.jar复制到Tomcat的 lib/ 目录，如果jira的lib目录中有相应的jaramail jar文件要移除。

另外，还需要添加相应数据库的JDBC驱动包，下载Mysql最新JDBC驱动包，解压后把jar文件复制到tomcat的lib目录下。把jira/WEB-INF/lib/目录下相应的mysql jdbc驱动包移除。

注意：Tomcat lib/目录下和jira/WEB-INF/lib/目录下的类包不要重复，上面mysql jdbc驱动包就是如此。

6. 配置 Tomcat

1).修改JIRA Context文件Tomcat conf/Catalina/localhost/jira.xml,docBase指向jira所在目录，数据库改为mysql,红色为修改部分:
<Contextpath="/jira" docBase="/opt/atlassian/jira"debug="0" useHttpOnly="true">

<!-- NOTE: If you use a database otherthan hsqldb:

* delete the minEvictableIdleTimeMillis andtimeBetweenEvictionRunsMillis attributes

* change the database type inatlassian-jira/WEB-INF/classes/entityengine.xml

-->

<Resource name="jdbc/JiraDS"auth="Container" type="javax.sql.DataSource"

username="jira"

password="jira"

driverClassName="com.mysql.jdbc.Driver"

url="jdbc:mysql://localhost/jira?autoReconnect=true&useUnicode=true&characterEncoding=UTF8"

maxActive="20"

validationQuery="select1"/>

<Resourcename="UserTransaction" auth="Container"type="javax.transaction.UserTransaction"

factory="org.objectweb.jotm.UserTransactionFactory"jotm.timeout="60"/>

<Manager pathname=""/>

</Context>

注意：如果数据库不是hsqldb,就把minEvictableIdleTimeMillis和timeBetweenEvictionRunsMillis参数注释掉。

2).修改tomcat server.xml文件(Tomcat conf/目录下)
打开server.xml文件，找到如下内容：

<Connector port="8080"protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="8443"/>

编辑这块增加 URIEncoding 属性：

<Connector port="8080" protocol="HTTP/1.1"

connectionTimeout="20000"

redirectPort="8443" URIEncoding="UTF-8"/>
7. jira相关配置

修改/opt/atlassian/jira/WEB-INF/classes/entityengine.xml：

<datasource name="defaultDS" field-type-name="hsql"

　 　schema-name="PUBLIC" <!--删除这一行-->

　 　修改为

<datasource name="defaultDS" field-type-name="mysql"

修改/opt/atlassian/jira/WEB-INF/classes/jira-application.properties

jira.home = /opt/atlassian/home/jira

8. 修正Tomcat内存设置

编辑 Tomcat's bin/setenv.sh (如果不存在则创建) 并设置：

export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true -Xms128m -Xmx512m -XX:MaxPermSize=256m"

9. 运行Tomcat并按向导初始化JIRA

重启tomcat，在浏览器输入http://<ip>:8080/jira，进入安装向导，可以通过向导安装和初始化JIRA。