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了。

CentOS 6.5上安装Confluence 5.4.4_第1张图片

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

七、汉化confluence

CentOS 6.5上安装Confluence 5.4.4_第2张图片

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

CentOS 6.5上安装Confluence 5.4.4_第3张图片

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

CentOS 6.5上安装Confluence 5.4.4_第4张图片

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

CentOS 6.5上安装Confluence 5.4.4_第5张图片

在站点管理中选择“语言”,将默认语言修改为中文(中国)。

CentOS 6.5上安装Confluence 5.4.4_第6张图片

选择中文(中国),提交。

CentOS 6.5上安装Confluence 5.4.4_第7张图片

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

CentOS 6.5上安装Confluence 5.4.4_第8张图片

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

八、确定confluence破解成功

CentOS 6.5上安装Confluence 5.4.4_第9张图片

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

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

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

CentOS 6.5上安装Confluence 5.4.4_第10张图片

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

CentOS 6.5上安装Confluence 5.4.4_第11张图片

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

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

CentOS 6.5上安装Confluence 5.4.4_第12张图片

CentOS 6.5上安装Confluence 5.4.4_第13张图片

CentOS 6.5上安装Confluence 5.4.4_第14张图片

CentOS 6.5上安装Confluence 5.4.4_第15张图片


CentOS 6.5上安装Confluence 5.4.4_第16张图片

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

CentOS 6.5上安装Confluence 5.4.4_第17张图片

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

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

CentOS 6.5上安装Confluence 5.4.4_第18张图片

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

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