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的安装配置就结束了。