本文共 9820 字，大约阅读时间需要 32 分钟。
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上传附件难度系数太高，只好作罢。
| 1 2 3 4 5 6 7 8 9 10 | 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
| 1 2 | 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
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | 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创建数据库
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 | [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
| 1 2 3 4 5 6 7 8 | [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的安装配置就结束了。
本文转自 jerry1111111 51CTO博客，原文链接：http://blog.51cto.com/jerry12356/1865562，如需转载请自行联系原作者