JIRA有两种类型的分发包:“ Recommended”,“ WAR”。
JIRA的“ Recommended”分发包:
包含JIRA配置工具;和tomcat应用服务器预先打包好;需要最小的安装;为所有用户推荐
JIRA的" WAR"分发包:
不包含JIRA配置工具;需要构建和部署到一个已经安装的应用服务器;需要进行 手工配置;适用于系统管理员
1.下载war分发包以及tomcat6
2.配置JIRA
2.1定制JIRA安装目录的文件(可选的,为专家推荐)
2.1.1如何定制
编辑 <jira-application-dir>\edit-webapp\WEB-INF\classes目录下的entityengine.xml文件
注意:定制的文件越多,升级或迁移到另一个服务器的难度越大
2.1.2配置entityengine.xml文件
2.2JIRA HOME
设置JIRA_HOME环境变量并建立相应目录
在 <jira-application-dir>\edit-webapp\WEB-INF\classes\jira-application.properties文件中
jira.home= X:\\path\\to\\JIRA\\Home ( windows下在子目录间用双后斜杠 )
3.构建JIRA
4.更新tomcat的安装类库(for JIRA)
4.1JDBC驱动
4.2其他的jira类库(for JIRA )
注意:
下面这些jar包在copy新的版本前要删掉旧版本
确保下面的jar包出现在Tomcat/lib下面,不要出现在JIRA/WEB-INF/lib下面
如果这些jar包出现在JIRA/WEB-INF/lib下面,需要删掉,重新构建JIRA
Tomcat 6 JARs: http://www.atlassian.com/software/jira/downloads/binary/jira-jars-tomcat-distribution-6.2-m07-tomcat-6x.zip
jcl-over-slf4j-x.y.z.jar jul-to-slf4j-x.y.z.jar log4j-x.y.z.jar slf4j-api-x.y.z.jar slf4j-log4j12-x-y-z.jar
Tomcat 7 JARs: http://www.atlassian.com/software/jira/downloads/binary/jira-jars-tomcat-distribution-6.2-m07-tomcat-7x.zip
5.在tomcat中配置JIRA的Context
在server.xml文件中或在jira.xml中,二者存其一
jira.xml路径: conf/Catalina/localhost/jira.xml
tomcat解析jira.xml时会把在虚拟目录的war包解压到webapp目录,目录名与Context的path值相同
server.xml中Context标签在Host标签下
6.修改tomcat的server.xml以处理国际化编码
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
7.在tomcat中修正memory和邮件处理设置
在tomcat的 bin/setenv.sh或 bin/setenv.bat文件
linux中:
export CATALINA_OPTS="$CATALINA_OPTS -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true -Xms512m -Xmx1024m -XX:MaxPermSize=512m"
windows中:
set CATALINA_OPTS=%CATALINA_OPTS% -Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true -Dmail.mime.decodeparameters=true -Xms512m -Xmx1024m -XX:MaxPermSize=512m
jvm参数值设置过低可能会导致内存溢出
8.启动tomcat
9.运行安装向导
source:
https://confluence.atlassian.com/display/JIRA/Installing+JIRA+on+Tomcat+6.0+or+7.0
https://confluence.atlassian.com/display/JIRA/Installing+JIRA+WAR