构建高效的团队协作工具(一) 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&amp;useUnicode=true&amp;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。