现在的位置: 首页 > 综合 > 正文

Centos 5.3 安装配置JIRA,Confluence手记

2013年07月16日 ⁄ 综合 ⁄ 共 5001字 ⁄ 字号 评论关闭

 

JIRA是一款专业的bug跟踪与项目管理软件(Issues Tracking)。由于公司管理需要,需要在开发服务器上安装配置JIRA。Confluence据说有点类似于wikipedia,官网上的解释是:“Confluence is an enterprise wiki that makes it easy for your team to collaborate and share knowledge.”。我最近也只是安装配置,并没有慢慢品味这两者给我们带来的便利,所以软件好用与否暂不做评论,只记录安装过程。

网上很多文章说如何整合安装JIRA和Confluence,但是我看到官网上好像并不推荐那样做(我回头去找那段E文,找不到了还),虽然中国服务论坛上有些文章提到整合的事情(好像也只是民间帖子)。简单起见,都是Standalone distribution 吧。只是把Confluence的端口改为8090。JIRA和Confluence的Standalone distribution 都是运行在内置tomcat上的,port默认都是8080。

 

JIRA的安装

1.java安装和设置JAVA_HOME

首先下载到sun官网下载jdk-6u20-linux-i586.bin(版本根据实际决定)。linux下可以使用wget命令。由于url忘记了,详细命令不写了。由于我们的开发服务器不在本地,我只能通过wget下载。(当然还有很多别的方法,见下文)我先把jdk-6u20-linux-i586.bin下载到/home/acm,然后执行sh自解压脚本

sh jdk-6u20-linux-i586.bin

yes人家的相关条款。如果顺利的话,当前目录会多一个jdk1.6.0_20。将该目录移动到/usr/local/,并改为名java。

设置环境变量JAVA_HOME

这一步有很多方法,修改各种配置文件中的一个。我采取的方法是

vi /etc/profile

在文件后面两行加上

export JAVA_HOME=/usr/local/java
export CLASSPATH=$CLASSPATH:$JAVA_HOME/lib:$JAVA_HOME/jre/lib
export PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$PATH:$HOME/bin
export JIRA_HOME=/usr/local/jira/

后面一行加粗的是后面配置JIRA_HOME时候加上去的(可选,因为JIRA本身有配置文件配置这个路径)。

修改完了配置文件,echo $JAVA_HOME一下必定得到空值。因为配置文件还没有生效,最简单的方法是 source一下

source /etc/profile

这个时候echo $JAVA_HOME 就会圆满了。

[root@dev ~]# echo $JAVA_HOME
/usr/local/java

不放心的话也可以验证一下其他路径。可以输入

java -version

看看是否得到如下结果:

java version "1.6.0_20"
Java(TM) SE Runtime Environment (build 1.6.0_20-b02)
Java HotSpot(TM) Server VM (build 16.3-b01, mixed mode)

顺便提一句,我之前在安装Centos时候,选安装了gcj,

rpm -aq|grep gcj

出来一堆东东。效果给不了了,因为写blog之前已经执行了如下命令

 yum -y remove java-1.4*

删除gcj,JIRA官网说仅有这个的话。JIRA是不会正常工作的,常常会发生一些莫名其妙的bug。为了避免一起混乱,我首先删除之。

2.JIRA安装

安装JIRA的前提是java正确安装了。如果上面通不过,JIRA不会正常工作。如果你需要外部external database的话,还需要安装好你的external database,准备好连接驱动jar包。JIRA本身默认有数据库,名字我都忘记了,我的做法是舍弃JIRA本身的数据库,使用mysql。由于mysql已经安装好了,我只需要准备连接jar包。

a.安装JIRA,首先下载atlassian-jira-enterprise-4.1.1-standalone.tar.gz。这里使用wget好象不行,我没有深究下去。因为atlassian-jira-enterprise-4.1.1-standalone.tar.gz的下载需要同意许可。可能找到具体的url也可以使用wget吧。我没有深究。因为我还有其他方式去实现。ftp,svn都在开发服务器上运行的很好。我是通过svn把下载的atlassian-jira-enterprise-4.1.1-standalone.tar.gz的送到开发服务器上的,目录还是/home/acm/。

cd /home/acm/
tar -zxvf atlassian-jira-enterprise-4.1.1-standalone.tar.gz
mv atlassian-jira-enterprise-4.1.1-standalone /usr/local/jira

下载mysql连接jar包,还是到/home/acm/下执行

wget http://mysql.ntu.edu.tw/Downloads/Connector-J/mysql-connector-java-5.1.12.tar.gz

然后解压并吧jar包复制一份到jira的lib目录下。

tar -zxvf mysql-connector-java-5.1.12.tar.gz
ls -al
ls -al mysql-connector-java-5.1.12
cd mysql-connector-java-5.1.12
cp mysql-connector-java-5.1.12-bin.jar /usr/local/jira/lib/

接下来就是修改JIRA的配置文件了。

有两文件需要修改,(我是不是忘记了什么?是的,还真忘了,还要配置JIRA_HOME,可以通过之前的办法设置,也可以修改jira-application.properties文件,

find /usr/local/jira/ -name jira-application.properties
vi /usr/local/jira/atlassian-jira/WEB-INF/classes/jira-application.properties

将jira.home =修改为你的路径。

首先修改atlassian-jira/WEB-INF/classes下的

vi  entityengine.xml

找到  <datasource>部分将field-type-name 修改为mysql。

修改为:

 <datasource name="defaultDS" field-type-name="mysql"

并且删除schema-name="PUBLIC",because it only works for a field-type-name of "hsql"。

然后修改conf下的server.xml文件

vi /conf/server.xml

找到数据库连接源部分,修改为

 <Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"
                    driverClassName="org.gjt.mm.mysql.Driver"
                    url="jdbc:mysql://localhost:3306/jira?autoRconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"
                    username="jira"
                    password="password"
                    maxActive="20"
                  />
注意在此之前你应该在你的mysql上建立jira数据库,字符集是UTF-8。开始的时候我的url部分只是写成:

url="jdbc:mysql://192.168.1.1:3306/jira"

IP地址是开发服务器的地址。这样启动JIRA访问的时候,发现老是提示404错误,这个错误折腾我几乎一个下午+晚上,因为我不会怀疑是这里出问题。当我在Google上搜解决办法时候,很多文章提到.jira-home.lock的问题。官网上也提到了。我删除了.jira-home.lock,重启JIRA,.jira-home.lock还是会自动生成,我很理所当然的认为就是这个文件在起作用。因为很多文章提到这家伙,一大群人深受其困扰。我把.jira-home.lock删除了,又生成了,依照官网修改JIRA_HOME,问题依旧。绝望之余又照某文章说在setenv.sh JAVA_OPTS里加入“-Djira.dev.mode=true”,还是不行。

这个时候,我重生了,一改我从不看日志文件的陋习,打开JIRA的日记文件,跑到/logs下查看了一下

vi catalina.out

看到很多错误日志说:mysql数据库连接不上,日志文件里给出我之前配置的那个IP地址。于是仔细查看/conf/server.xml文件,没发现什么毛病,不得已就把IP地址修改为localhost。重启JIRA,perfect!!It works!

对了,关闭和启动JIRA的方法是:

/bin目录下执行:

./shutdown.sh
./startup.sh

这个时候就可以通过浏览器访问JIRA 了,IP地址(或者域名)加上端口号8080。然后就可以按照提示一步一步完成JIRA的配置了。

使用时候发现,界面上中文完美显示。插入到数据库的中文,读出来的中文,乱码。解决方案是:

将数据库连接源配置文件中的:

url="jdbc:mysql://localhost:3306/jira"

修改为

url="jdbc:mysql://localhost:3306/jira?autoRconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"

看来真是办法总比问题多呀,哈哈。解决问题后的心情真不错。

<!--事隔一天总结,也许漏了某些步骤-->

 

Confluence的安装

有了前面的经历,安装Confluence相对顺利。首先下载解压 confluence-3.2.1_01-std.tar.gz,移动到你的安装目录下。然后创建一个Confluence Home directory,然后

  1. find this file: confluence/WEB-INF/classes/confluence-init.properties
  2. Open the confluence-init.properties file in a text editor.

修改之。

然后打开server.xml,You need to modify both the server port (default is 8000) and the connector port (default is 8080) to ports that are free on your machine.

like that

 

 

抱歉!评论已关闭.