在 Tomcat6 上发布 JIRA 4.2.1

刚刚搞了下JIRA的发布，发现JIRA的官方文档很详细，比起CAS好得多。

 

直入正题，下面说下发布JIRA时候需要注意的一些事项：

 

1. 下载JIRA的发布包（不是Standalone），这个是4.2.1的下载地址：http://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-enterprise-4.2.1-b588.zip

2. 首先将JIRA的依赖包放入%CATALINA_HOME%/lib中，依赖包的下载地址：http://confluence.atlassian.com/download/attachments/200709089/jira-jars-tomcat6.zip?version=1&modificationDate=1252474277487，下载这个压缩包后解压即可；

3. 将发布包解压，运行里面的build.bat，build完之后进入dist-tomcat/tomcat-6，将jira.xml复制入%CATALINA_HOME%/conf/Catalina/localhost中

4. 定义jira.home属性，在%CATALINA_OPTS%中增加一个定义：-Djira.home=D:/jira（请注意这里使用的是“/”而不是“/”）。这里说明一下，定义%JIRA_HOME%环境变量好像不起作用，所以还是自己定义jira.home吧。

4. 运行Tomcat，整个初始化过程可能需要一分钟左右，然后在webapps中就多出了一个jira文件夹，如果控制台中不出现ERROR以上的错误，那就证明发布成功了，访问 http://localhost:8080/jira 即可见到jira。

 

 

附：

 

jira.xml的作用及配置：

<!--A sample configuration file for Tomcat 6Customize the docBase attribute, drop in your $CATALINA_HOME/conf/Catalina/localhost/jira.xmlNote the JOTM dependencies; you'll need to copy various jars to Tomcat's common/lib/ directory.--><Context path="/jira" docBase="D:/atlassian-jira-enterprise-4.2.1-b588/dist-tomcat/tomcat-6/atlassian-jira-4.2.1-b588.war" debug="0" useHttpOnly="true"> <!-- NOTE: If you use a database other than hsqldb: * delete the minEvictableIdleTimeMillis and timeBetweenEvictionRunsMillis attributes * change the database type in atlassian-jira/WEB-INF/classes/entityengine.xml --> <Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource" username="sa" password="" driverClassName="org.hsqldb.jdbcDriver" url="jdbc:hsqldb:D:/atlassian-jira-enterprise-4.2.1-b588/database/jiradb" minEvictableIdleTimeMillis="4000" timeBetweenEvictionRunsMillis="5000"/> <Resource name="UserTransaction" auth="Container" type="javax.transaction.UserTransaction" factory="org.objectweb.jotm.UserTransactionFactory" jotm.timeout="60"/> <Manager pathname=""/></Context>

以上是初始的jira.xml

其中：

Context节点中有两个属性，path及docBase，path即是发布之后之后的访问路径，docBase代表war包的位置，即是可以通过这个配置文件自动发布jira到webapps下。可以通过自定义这两个属性达到自定义发布的目的。

第一个Reourse节点定义了一个数据源，从驱动可以看出其使用的是内存文件数据库，而url属性则定义了这个数据库的位置，通常都是定义在%JIRA_HOME%/database/jiradb中

 

最后补充一点，我发布jira的时候是删掉jira发布包内的log4j的包的，因为log4j的包在第二步已经被复制到%CATALINA_HOME%/lib下，而官方的安装指引提到不要让common-logging和log4j的包在项目中出现，所以我将对应的包在项目中移除了，成功发布。如果不移除会怎样，欢迎大家尝试之后告诉我～～～

 

参考资料：http://confluence.atlassian.com/display/JIRA/Installing+JIRA+on+Tomcat+6.0