Confluence介绍:
Confluence是一个专业的企业知识管理与协同软件,也可以用于构建企业wiki。使用简单,但它强大的编辑和站点管理特征能够帮助团队成员之间共享信息、文档协作、集体讨论,信息推送 -- from 百度百科
其他的团队协作软件还有国内的 蓝湖 等...
环境准备:
- 服务器 我这里使用的是ubunru14.04
- JDK 因为Confluence是基于Java的,因此Java环境是必须的
- DB 我这里使用Mysql5.7
JDK环境准备:
可参考这篇博客中的JDK部署: www.yangxiao2.xyz/?p=136
Mysql安装:
sudo apt-get install mysql-server
sudo apt-get install mysql-client
sudo apt-get install libmysqlclient-dev
# 安装的过程中会输入root用户的密码, 要记住
Confluence的安装、破解与初始化:
下载
wget https://downloads.atlassian.com/software/confluence/downloads/atlassian-confluence-6.7.1-x64.bin -P /opt/
安装:
chmod +x atlassian-confluence-6.7.1-x64.bin #加执行权限
./atlassian-confluence-6.7.1-x64.bin
安装过程中会有交互信息
到这里confluence就已经安装好了,我们接下来下载破解软件进行破解:files.cnblogs.com/files/Javam…
破解步骤:
- 先把confluence安装目录下的jar包传回本地:
cp /opt/atlassian/confluence/confluence/WEB-INF/lib/atlassian-extras-decoder-v2-3.3.0.jar /home/live/ #备份一份
# 备注 从服务器传文件到本地的话可以用 xftp 或者 winscp等工具
# 服务端的jar包传回到本地之后 重命名为: atlassian-extras-2.4.jar
- 打开破解软件包中的 confluence_keygen.jar, 在图形化界面 点击 ' .patch ' 选择你从服务器传回来的jar包, jar包就破解成功
- 将破解之后的jar传回服务端原目录下,并重命名为 atlassian-extras-decoder-v2-3.3.0.jar
- 将 破解包里的 mysql-connector-java-5.1.44-bin.jar 传至服务器confluence安装目录下 /opt/atlassian/confluence/confluence/WEB-INF/lib
- 重启 Confluence
sh /opt/atlassian/confluence/bin/stop-confluence.sh
sh /opt/atlassian/confluence/bin/start-confluence.sh
访问服务器IP:8090 端口:
选择语言和选择安装方法,选择 Prodution Installation 安装
这里可以直接点Nest 下一步
到这里是最关键的,打开破解软件 Name: 输入英文 Server ID:将confluence页面上的Confluence的Server ID 输入进去之后 点 .gen 按钮,就会生成一个key, 复制key 填写到 confluence的页面中进入下一步:
企业的话建议购买, 个人使用可以破解
配置数据库:
选择我自己的数据库
配置数据库之前需要在mysql中新建用户和新建confluence数据库,并分配权限:
CREATE USER 'confluence'@'localhost' IDENTIFIED BY 'password'; # 新建confluence用户
CREATE DATABASE 'confluence' DEFAULT CHARACTER SET utf8 COLLATE utf8_bin; # 新建数据库
GRANT ALL PRIVILEGES ON confluence.* TO "confluence"@"%" IDENTIFIED BY "password"; # 分配权限
# 数据库的my.cnf配置文件新增以下配置:
init_connect='SET collation_connection = utf8_unicode_ci'
init_connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_unicode_ci
skip-character-set-client-handshake
transaction-isolation=READ-COMMITTED
# 重启mysql
数据库配置好了之后就可以在页面上填入数据库信息了, 数据库类型选择 MySQL,安装类型选择 通过连接字符串 数据库URL jdbc:mysql://localhost/confluence 再输入数据库用户名和密码
这里注意数据库URL后还要加一个字符串,指定隔离级别,不加的话可能会报错,所有完整的数据库URL为:
jdbc:mysql://localhost/confluence?sessionVariables=tx_isolation='READ-COMMITTED'
配置好之后点测试连接, 如果测试成功,点下一步继续安装,这里等几分钟数据库设置好之后就可以进入confluence配置admin账户信息, 配置好后就可以开始使用啦。
Confluence 使用中常见踩坑总结:
- 如果使用了nginx代理, 可能会一直报一个 BASE_URL error 的错误
解决办法:
第一步: 用管理员账户登录之后修改服务器主页URL
第二步: 在插件管理界面 禁用 Confluence Base URL Plugin 这个插件 件
- 不能上传大文件
解决办法:
原因1: 可能是附件大小限制, 可联系管理员 在 一般配置里更改附件大小限制
原因2: 如果更改了附件大小限制后还是不能上传,可能是用了nginx代理, 代理限制了大小, 需要在nginx配置文件中加入下边这行配置:
client_max_body_size 1024M; #大小按需更改
- 预览附件时 附件内的中文显示乱码
原因: 服务器上没有Microsoft字体
解决办法:
- 创建字体文件夹
mkdir -p /usr/share/fonts/msttcore
- 把window系统下 C:\Windows\Fonts\ 下的所有字体全部上传到上面新建的字体文件夹
- 修改confluence的配置文件:
修改前先把原配置文件copy一份
cp /opt/atlassian/confluence/bin/setenv.sh ~/setenv.sh # 这里的目录根据实际安装目录修改
vim /opt/atlassian/confluence/bin/setenv.sh
# 搜索`CATALINA_OPTS`, 在最后一个匹配行后,追加如下行:
CATALINA_OPTS="-Dconfluence.document.conversion.fontpath=/usr/share/fonts/msttcore ${CATALINA_OPTS}" #指定字体目录
- 备份缓存后删除 (不清缓存只有新上传的附件才会显示正常)
#备份
cp -r /var/atlassian/application-data/confluence/viewfile/ /root/viewfile_20180114
cp -r /var/atlassian/application-data/confluence/shared-home/ /root/shared-home_20180114
cp -r /var/atlassian/application-data/confluence/thumbnails/ /root/thumbnails_20180114
#清空缓存
rm -rf /var/atlassian/application-data/confluence/viewfile/*
rm -rf /var/atlassian/application-data/confluence/thumbnails/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-document/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-document_hd/*
rm -rf /var/atlassian/application-data/confluence/shared-home/dcl-thumbnail/*
- 重启confluence
sh /opt/atlassian/confluence/bin/stop-confluence.sh
sh /opt/atlassian/confluence/bin/start-confluence.sh
重启之后再次预览附件, 附件中的中文就显示正常啦
最后附一个官网的解决方法,可以尝试下: The Text in a PowerPoint, Excel or Word Document is Missing or Looks Different when Using the Viewfile Macro
~over~