构建高效的团队协作工具(一) Jira安装配置

朱雀 2022-09-25 08:23 187阅读 0赞

Jira是基于web的问题跟踪和项目管理软件解决方案,JIRA广泛地应用于全球上千家企业和开源组织.可以作为bug跟踪,缺陷跟踪,项目管理软件,JIRA使用简单,配置灵活,有完善的权限管理以及扩展性。

1.      系统环境

> <table> 
> <tbody> 
> <tr> 
> <td> OS: </td> 
> <td> CentOS release 5.6 </td> 
> </tr> 
> <tr> 
> <td> Jdk: </td> 
> <td> 1.6.0_26 </td> 
> </tr> 
> <tr> 
> <td> Web Server: </td> 
> <td> tomcat-6.0.32 </td> 
> </tr> 
> <tr> 
> <td> DB: </td> 
> <td> MySQL Community Server 5.5.15 </td> 
> </tr> 
> <tr> 
> <td> Jdbc </td> 
> <td> mysql-connector-java-5.1.17 </td> 
> </tr> 
> <tr> 
> <td> Jira: </td> 
> <td> atlassian-jira-enterprise-4.2.1-b588(war) </td> 
> </tr> 
> <tr> 
> <td> &nbsp; </td> 
> <td> &nbsp; </td> 
> </tr> 
> </tbody> 
> </table>

> 系统环境配置在这里不进行描述，假设tomcat、mysql等环境配置完成。

2.      目录规划

> <table> 
> <tbody> 
> <tr> 
> <td> /usr/local/jdk1.6 </td> 
> <td> Jdk 安装目录，JAVA_HOME及CLASSPATH设置为全局环境变量 </td> 
> </tr> 
> <tr> 
> <td> &nbsp; </td> 
> <td> mysql使用rpm默认安装路径 </td> 
> </tr> 
> <tr> 
> <td> /opt/tomcat6 </td> 
> <td> Tomcat安装目录 </td> 
> </tr> 
> <tr> 
> <td> /opt/atlassian </td> 
> <td> Atlassian产品安装的父目录 </td> 
> </tr> 
> <tr> 
> <td> /opt/atlassian/home </td> 
> <td> Atlassian产品主目录，jira_home是在/opt/atlassian/home/jira </td> 
> </tr> 
> <tr> 
> <td> /opt/atlassian/jira </td> 
> <td> Jira安装目录 </td> 
> </tr> 
> </tbody> 
> </table>

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][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][jira-jars-tomcat6.zip] (1.5Mb),解压并复制其中包含的jar文件到Tomcat的 lib/ 目录.
> 
> 所需javamail类包，mail.jar下载地址   
> [http://www.oracle.com/technetwork/java/index-138643.html][http_www.oracle.com_technetwork_java_index-138643.html]  
> activation.jar（即JAF）下载地址  
> [http://www.oracle.com/technetwork/java/index-135046.html][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"> 
>   
>      
>     <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。

[JIRA4.2.1 Enterprise - WAR_EAR]: http://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-enterprise-4.2.1-b588.tar.gz
[jira-jars-tomcat6.zip]: http://confluence.atlassian.com/download/attachments/231932640/jira-jars-tomcat6.zip?version=1&modificationDate=1252474277487
[http_www.oracle.com_technetwork_java_index-138643.html]: http://www.oracle.com/technetwork/java/index-138643.html
[http_www.oracle.com_technetwork_java_index-135046.html]: http://www.oracle.com/technetwork/java/index-135046.html