CentOS 6.5上安装Confluence 5.4.4

Confluence是一个专业的企业知识管理与协同软件，也可以用于构建企业wiki。通过它可以实现团队成员之间的协作和知识共享。

                                                                                                                                               --摘抄自百度百科

一般而言，confluence可以结合jira使用，作为团队协作和共享知识文档的平台，所以我在之前部署jira的环境上进行confluence的部署。

一、下载confluence

所需要的软件有：

confluence源码安装包：atlassian-confluence-5.4.4.tar.gz

confluence破解压缩包：confluence5.1-crack.zip

confluence破解jar包：atlassian-extras-2.4.jar

confluence中文语言包：Confluence-5.4.4-language-pack-zh_CN.jar

mysql java驱动包：mysql-connector-java-5.1.33-bin.jar

很想把使用到的软件包上传上来，但是51cto上传附件难度系数太高，只好作罢。

cd /opt/tools
mkdir confluence
rz -y   #上传confluence需要的软件
cd confluence/
[root@server136 confluence]# ll
total 194360
-rw-r--r-- 1 cuser users 197890899 Oct 20 10:51 atlassian-confluence-5.4.4.tar.gz
-rw-r--r-- 1 cuser users    148874 Oct 20 10:52 atlassian-extras-2.4.jar
-rw-r--r-- 1 cuser users    632101 Oct 20 10:53 confluence5.1-crack.zip
-rw-r--r-- 1 cuser users    340849 Oct 20 10:52 Confluence-5.4.4-language-pack-zh_CN.jar

二、安装confluence

tar -zxf atlassian-confluence-5.4.4.tar.gz
mv atlassian-confluence-5.4.4 /usr/local/confluence

默认情况下，confluence中的文件如下：

[root@server136 confluence]# ll /usr/local/confluence/

total 108

drwxr-xr-x  2 root root  4096 Oct 20 10:56 bin

drwxr-xr-x  2 root root  4096 Oct 20 10:56 conf

drwxr-xr-x 25 root root  4096 Oct 20 10:56 confluence

drwxr-xr-x  2 root root  4096 Oct 20 10:56 lib

-rw-r--r--  1 root root 38657 Nov 28  2011 LICENSE

drwxr-xr-x  3 root root  4096 Mar 13  2014 licenses

drwxr-xr-x  2 root root  4096 Nov 28  2011 logs

-rw-r--r--  1 root root   574 Nov 28  2011 NOTICE

-rw-r--r--  1 root root  2291 Mar 13  2014 README.html

-rw-r--r--  1 root root  1212 Mar 13  2014 README.txt

-rw-r--r--  1 root root  8680 Nov 28  2011 RELEASE-NOTES

-rw-r--r--  1 root root  6836 Nov 28  2011 RUNNING.txt

drwxr-xr-x  2 root root  4096 Oct 20 10:56 temp

drwxr-xr-x  2 root root  4096 Mar 13  2014 webapps

drwxr-xr-x  2 root root  4096 Nov 28  2011 work

chown -R root:root /usr/local/confluence/  #添加授权
mkdir -p /usr/local/confluence_home  #创建confluence_home
cp /usr/local/confluence/confluence/WEB-INF/classes/confluence-init.properties /usr/local/confluence/confluence/WEB-INF/classes/confluence-init.properties.bak
vi /usr/local/confluence/confluence/WEB-INF/classes/confluence-init.properties
# 在该文件中指定confluence_home的文件路径
[root@server136 confluence]# egrep -v "#|^$" /usr/local/confluence/confluence/WEB-INF/classes/confluence-init.properties
confluence.home=/usr/local/confluence_home
[root@server136 confluence]# ll /usr/local/confluence_home
total 0
[root@server136 confluence]# lsof -i :8090
# 查看8090端口是否被占用
[root@server136 confluence]# /usr/local/confluence/bin/start-confluence.sh # 启动confluence
To run Confluence in the foreground, start the server with start-confluence.sh -fg
executing as current user
If you encounter issues starting up Confluence Standalone, please see the Installation guide at http://confluence.atlassian.com/display/DOC/Confluence+Installation+Guide
Server startup logs are located in /usr/local/confluence/logs/catalina.out
Using CATALINA_BASE:   /usr/local/confluence
Using CATALINA_HOME:   /usr/local/confluence
Using CATALINA_TMPDIR: /usr/local/confluence/temp
Using JRE_HOME:        /usr/local/jdk
Using CLASSPATH:       /usr/local/confluence/bin/bootstrap.jar
Using CATALINA_PID:    /usr/local/confluence/work/catalina.pid
[root@server136 confluence]# lsof -i :8090   
COMMAND  PID USER   FD   TYPE DEVICE SIZE/OFF NODE NAME
java    4172 root   30u  IPv4 168008      0t0  TCP *:8090 (LISTEN)

三、为confluence创建数据库

[root@server136 confluence]# mysql -uroot -p
Enter password: 
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 684
Server version: 5.6.16 Source distribution
Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql> create database confluence character set utf8;
Query OK, 1 row affected (0.00 sec)
mysql> show create database confluence;
+------------+---------------------------------------------------------------------+
| Database   | Create Database                                                     |
+------------+---------------------------------------------------------------------+
| confluence | CREATE DATABASE `confluence` /*!40100 DEFAULT CHARACTER SET utf8 */ |
+------------+---------------------------------------------------------------------+
1 row in set (0.00 sec)
mysql> grant all on confluence.* to confluence@'localhost' identified by 'wiki@CY2o16';
Query OK, 0 rows affected (0.00 sec)
mysql> flush privileges;
Query OK, 0 rows affected (0.00 sec)
mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| confluence         |
| jira               |
| mysql              |
| performance_schema |
| test               |
+--------------------+
6 rows in set (0.00 sec)
mysql> quit
Bye

四、启动confluence

[root@server136 storage]# cp /opt/tools/mysql-connector-java-5.1.33-bin.jar  
/usr/local/confluence/confluence/WEB-INF/lib/
# 拷贝mysql的Java连接驱动包到confluence的lib目录下
[root@server136 storage]# ll /usr/local/confluence/confluence/WEB-INF/ 
lib/mysql-connector-java-5.1.33-bin.jar 
-rw-r--r-- 1 root root 959987 Oct 20 13:06 /usr/local/confluence/confluence/WEB-INF/lib/mysql-connector-java-5.1.33-bin.jar
[root@server136 storage]# chown -R root:root /usr/local/confluence/
[root@server136 storage]# /usr/local/confluence/bin/start-confluence.sh

五、confluence注册码破解

1、解压confluence破解压缩包

[root@server136 confluence]# unzip confluence5.1-crack.zip 

Archive:  confluence5.1-crack.zip

   creating: confluence5.1-crack/

  inflating: confluence5.1-crack/atlassian-extras-2.4.jar  

   creating: confluence5.1-crack/iNViSiBLE/

  inflating: confluence5.1-crack/iNViSiBLE/confluence_keygen.jar  

  inflating: confluence5.1-crack/iNViSiBLE/keygen.bat  

  inflating: confluence5.1-crack/iNViSiBLE/keygen.sh  

  inflating: confluence5.1-crack/iNViSiBLE/keygen_MacOSX.sh  

[root@server136 confluence]# ls confluence5.1-crack

atlassian-extras-2.4.jar  iNViSiBLE

2、将压缩包中的atlassian-extras-2.4.jar移动到别处

[root@server136 confluence]# mv confluence5.1-crack/atlassian-extras-2.

.4.jar /tmp/

3、将源码安装好的confluence中的atlassian-extras-2.4.jar拷贝到破解目录中

[root@server136 confluence]# cp /usr/local/confluence/confluence/WEB-INF/lib/atlassian-extras-2.4.jar /usr/local/confluence/confluence/WEB-INF/lib/atla

assian-extras-2.4.jar.backup

# 先对要操作的jar文件进行备份

[root@server136 confluence]# /usr/local/confluence/bin/stop-confluence.

.sh 

# 然后停止confluence

[root@server136 confluence]# mv /usr/local/confluence/confluence/WEB-IN

NF/lib/atlassian-extras-2.4.jar confluence5.1-crack/

# 再将jar包移动到破解补丁目录中

[root@server136 confluence]# cd confluence5.1-crack

[root@server136 confluence5.1-crack]# ll

total 148

-rw-r--r-- 1 root root 147405 Mar  3  2014 atlassian-extras-2.4.jar

drwxr-xr-x 2 root root   4096 Oct 25  2010 iNViSiBLE

# 这里看到的jar包就是安装confluence的源码包中的jar包，是破解前的jar包，注意文件大小，等破解之后方便辨识

4、执行破解补丁程序进行破解

[root@server136 confluence5.1-crack]# cd iNViSiBLE/

[root@server136 iNViSiBLE]# ls

confluence_keygen.jar  keygen.bat  keygen_MacOSX.sh  keygen.sh

# 一共有3个脚本，对应Windows/MacOS/Linux不同的系统，注意一定要保证confluence_keygen.jar和脚本在同一个目录（默认iNViSiBLE）

[root@server136 iNViSiBLE]# chmod +x keygen.sh

[root@server136 iNViSiBLE]# ./keygen.sh 

注意：如果CentOS安装了图形界面，那执行这个shell脚本就会出现图形界面，而且只有在图像界面下才能进行破解操作，如果Linux服务器没有安装图形界面，可以把这个破解程序拷贝到Windows或者mac客户端，在客户端上安装Java环境之后，使用对应的keygen.bat或者keygen_MacOSX.sh进行操作。由于我这里CentOS没有安装图形界面，所以我到Windows下进行操作。

输入破解补丁需要的信息，然后点击gen!就会生成破解key，然后将atlassian-extras-2.4.jar拖入窗口，patch！按钮就会变为可点击状态，点击patch!就会重新生成一个新的atlassian-extras-2.4.jar，而原有的atlassian-extras-2.4.jar会变为atlassian-extras-2.4.jar.back，自动生成备份。

5、将破解后的atlassian-extras-2.4.jar上传到confluence安装目录中

rz -y #先把破解后的atlassian-extras-2.4.jar上传到root目录

mv /root/atlassian-extras-2.4.jar 

/usr/local/confluence/confluence/WEB-INF/lib/ #将文件移动到confluence的对应目录

/usr/local/confluence/bin/start-confluence.sh #启动confluence

六、浏览器中配置confluence

输入之前破解生成的key，然后选择生产环境安装。

选择数据库的类型，然后点击额外的数据库。

选择使用JDBC连接数据库，点击“Direct JDBC”。

这里会自动生成Driver Class Name和Database URL，注意上面的提示，如果打算使用非拉丁字符集，需要在Database URL的最后添加&useUnicode=true&characterEncoding=utf8，所以这里需要加上这段代码，然后输入mysql数据库中的用户名和密码（当然是对confluence数据库有权限的用户），下一步。

选择载入内容，可以是示例站点，空站点，也可以从备份文件还原站点，当然我这里选择空站点。

配置用户管理，有两种方式，第一种是使用confluence管理用户和组，选择该方式可以手工创建用户和组，当然也可以通过ldap方式进行用户管理，上面还有提示：如果打算通过ldap或者crowd服务器和confluence进行连接，就必须使用第一种方式。第二种方式是通过JIRA来管理用户和组，适用于jira 4.3及以上版本，这种方式就不需要创建用户了，直接把jira中的用户和组同步过来，然后在jira中对用户和组进行管理，当然这种情况下如果用户数超过500官方是不推荐使用该方法的。因为我打算使用ldap进行confluence用户和组的管理，所以这里选择第一种方式“Manage users and groups within Confluence”。

安装成功，可以开始使用confluence或者进行更多配置，这里就开始使用confluence了。

重新打开confluence的连接，出现confluence的欢迎页。

七、汉化confluence

点击首页上的螺丝形按钮，然后选择“Add-ons”，在打开的页面中选择左侧的“Manage add-ons”，点击右上的“Upload add-on”，然后在弹出的窗口中选择之前下载好的confluence中文语言包Confluence-5.4.4-language-pack-zh_CN.jar，然后上传。

confluence会自动在上传后进行安装。

成功安装后的界面如上图所示。

在站点管理中选择“语言”，将默认语言修改为中文（中国）。

选择中文（中国），提交。

为了能让confluence正常显示pdf，还需要对PDF导出语言支持进行设置，因为自带的语言包对中文支持不好，所以我们上传一个中文字体。

导入成功后，选择“Install”，正常情况下，不到一分钟就能安装成功。

八、确定confluence破解成功

由于在安装之前就已经进行了破解的操作，这里在管理站点中选择“授权”，查看一下授权信息，可以看到这里的技术支持期限已经为2337年12月24日了，可以尽情使用了。

九、使用openLDAP进行confluence的用户身份认证

在管理站点中选择左侧的“用户目录”，然后选择“添加目录”。

将openLDAP信息补充完全之后，选择保存。

输入openLDAP中的用户进行测试，测试结果全部通过说明openLDAP配置成功。

下面给出openLDAP的配置详细信息（由于这里使用的ldap服务器还是之前jira中的ldap服务器，所以关于openLDAP的信息就不再重复给出，如需要可以移步之前的文章，点击此处）：

配置成功后，在用户中已经成功从openLDAP中同步过来用户和组，注意同步过来之后的用户并不在confluence-users组当中，但是默认confluence-users组是可以登录confluence的最小权限组。

退出管理员登录，然后使用openLDAP中的用户进行登录。

登录成功，说明打到了理想的效果。

然后再次使用管理员登录，查看组的信息，可以看到已经登录过confluence的测试用户已经添加到confluence-users组中了，这个是confluence自动操作，非人为手工添加的。

至此，confluence的安装配置就结束了。