Jira 3.5 Enterprise EAR/WAR + mysql 安装手记

Jira 3.5 Enterprise EAR/WAR + mysql 安装手记

前段时间很容易的就试装了jira的Professional Standalone， 写得比较简单，今天准备装一下Enterprise EAR/WAR ，写个详细一点安装手记。

最开始的工作自然是下载了。
把zip包解压到一个目录中，展开的内容如下：
edit-webapp：这个目录中放的是指定数据库类型的配置文件；
etc：这个目录中存放有三个xml文件；分别是换ear/war包用的配置文件；
         打war包的配置文件有两一个，jira.xml是通用的，tomcat-5.5-jira.xml是专为tomcat-5.5准备的。
src：这是一个空目录，可以放自己添加的要编译的功能源文件；
tools：这个目录中自带一个ant（如果你没有安装ant，就用得到它）；
updater：为更新jira配备的一个更新工具目录；
webapp：主要的程序文件目录；
appendcp.bat：这个批处理文件没怎么用到；
build.bat：这个批处理文件把修改过的配置文件和程序文件打成一个可发布的war/ear包；
build.sh：功能同build.bat,是在linux下用的；
build.xml：ant的配置文件；
readme.txt：软件说明文件；

展开的这些东西还只是“材料”，接下来就是做一些配置并把它们打成可发布的包。

应用服务选用Tomcat5.0；
数据库选用mysql Ver 14.7 Distrib 4.1.14 for Win32；

先建表空间，再分配用户指定权限，

create   database  jiradb;
grant   all  privileges  on  jiradb. *   to  jiradbuser @localhost  identified  by   ' jira ' ;

做好外部了准备工作，就进行配置。
接着修改 edit-webapp\WEB-INF\classes\entityengine.xml，
找到

     < datasource  name ="defaultDS"  
        field-type-name ="hsql"
        helper-class ="org.ofbiz.core.entity.GenericHelperDAO"
        check-on-start ="true"
        use-foreign-keys ="false"
        use-foreign-key-indices ="false"
        check-fks-on-start ="false"
        check-fk-indices-on-start ="false"
        add-missing-on-start ="true"
        check-indices-on-start ="true" >

替换为

     < datasource  name ="defaultDS"  
        field-type-name ="mysql"
        helper-class ="org.ofbiz.core.entity.GenericHelperDAO"
        check-on-start ="true"
        use-foreign-keys ="false"
        use-foreign-key-indices ="false"
        check-fks-on-start ="false"
        check-fk-indices-on-start ="false"
        add-missing-on-start ="true"
        check-indices-on-start ="true" >

再修改 etc\jira.xml（如果应用服务用tomcat5.5,则修改 etc\tomcat-5.5-jira.xml）
找到

     < parameter >
       < name > driverClassName </ name >
         <!--  NOTE: if you change the database type, you will need to change it in WEB-INF/classes/entityengine.xml  -->
       < value > org.hsqldb.jdbcDriver </ value >
     </ parameter >
     < parameter >
       < name > url </ name >
       < value > jdbc:hsqldb:@JIRA_HOME@/database/jiradb </ value >
     </ parameter >
     < parameter >
       < name > username </ name >
       < value > sa </ value >
     </ parameter >
     < parameter >
       < name > password </ name >
       < value > </ value >
     </ parameter >

修改为

     < parameter >
       < name > driverClassName </ name >
         <!--  NOTE: if you change the database type, you will need to change it in WEB-INF/classes/entityengine.xml  -->
       < value > com.mysql.jdbc.Driver </ value >
     </ parameter >
     < parameter >
       < name > url </ name >
       < value > jdbc:mysql://localhost:3306/jiradb?autoReconnect=true </ value >
     </ parameter >
     < parameter >
       < name > username </ name >
       < value > jiradbuser </ value >
     </ parameter >
     < parameter >
       < name > password </ name >
       < value > jira </ value >
     </ parameter >

配置完后，就可以build一个jira的war包了。
如果系统中已装有ant，则直接运行build.bat文件，没有安装的话，它会运行自带的ant。

build运行完后，会在当前目录生成三个目录，
dist-generic：存放通用的war包，直接拷贝到应用服务的服务目录中就可以运行；
dist-tomcat：存放发布到tomcat中的外部war包及配置文件；
tmp：build运行过程中的临时文件目录；

dist-tomcat目录中，有一个war包，和对应三个tomcat版本的配置文件目录。

在此，拷贝 dist-tomcat/tomcat-5/jira.xml 到 $Tomcat/conf/Catalina/localhost/
启动tomcat,在IE地址样中输入： http://localhost:8080/jira；
第一次运行jira，显示安装配置页面。（没有装截图软件，就不显示截图）
在这个配置页面，jira会根据操作系统的语言设置，选用相应的语言包（汉包的效果也不错，不存在语言问题：）），依照着相关的提示做相应的设置就OK，唯一花时间的事，就是要在线生成一个授权码，用下载jira的用户名登录，可以获得一个援权码，填好援权码下一步。
接下来是添加管理员，设置好后下一步。
再接下来是邮件通知的设置，此处你可以暂时禁用邮件通知，以后也可以重新启动邮件通知。
设置完成后就可以以刚才添加的管理员登录，创建BUG跟踪管理项目了。