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所需的schema4. 生成jira工程
mysql> create database jira character set utf8;
mysql> grant all on jira.* to jira@'localhost' identified by'jira';
下载 JIRA4.2.1 Enterprise - WAR/EAR(选择WAR版本主要是觉得可灵活配置),解压到一临时目录(例如:/opt/resource)。5. 更新Tomcat类包
切换到解压后的目录中,运行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生成)。
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下载地址
另外,还需要添加相应数据库的JDBC驱动包,下载Mysql最新JDBC驱动包,解压后把jar文件复制到tomcat的lib目录下。把jira/WEB-INF/lib/目录下相应的mysql jdbc驱动包移除。
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文件要移除。
注意: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。