confluence的安装、使用与维护

记录一下confluence的安装、使用与维护。

¶安装

confluence需要jdk和数据库，这里选择mysql数据库。为了方便维护，使用宝塔面板安装和创建Mysql数据库。版本号可以参考Supported Platforms。

¶安装JDK

confluence不能使用openjdk，只能使用oracal jdk。所以如果服务器之前安装了openjdk，请先卸载。jdk可以在镜像网站injdk下载，建议使用jdk11。如果已安装，跳过此步。

# 需要root权限
cd /usr/local
wget https://d6.injdk.cn/oraclejdk/11/jdk-11.0.12_linux-x64_bin.tar.gz
tar -xf jdk-11.0.12_linux-x64_bin.tar.gz

编辑/etc/bash.bashrc或/etc/bashrc，文件最后加入如下内容。

1
2
3

export JAVA_HOME=/usr/local/jdk-11.0.12
export CLASSPATH=$JAVA_HOME/lib
export PATH=$JAVA_HOME/bin:$PATH

退出登录，再次登录服务器。使用如下命令验证安装是否成功。

pk@pk:~$ java --version
java 11.0.12 2021-07-20 LTS
Java(TM) SE Runtime Environment 18.9 (build 11.0.12+8-LTS-237)
Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.12+8-LTS-237, mixed mode)
pk@pk:~$ which java
/usr/local/jdk-11.0.12/bin/java

¶创建数据库

进入宝塔面板。如果没有安装mysql数据库，需要先在软件商店安装mysql，推荐安装mysql8。如果已经安装低版本的mysql，需要卸载重新安装mysql8。

mysql安装好之后，点击左侧的数据库，点击添加数据库，填写数据库名和用户名，编码选择utf-8，点击提交。记住数据库名、用户名和密码。

安装宝塔面板可以参考 bt.cn。

¶修改数据库排序规则

点击数据库右侧的管理，进入phpMyadmin，执行如下SQL语句。将数据库名替换为刚刚创建的数据库。如果没有安装phpMyadmin，可以在软件商店搜索安装。

1	alter database 数据库名 default collate utf8_bin;

¶修改数据库隔离级别

在宝塔面板进入mysql的设置页面，选中左侧的配置修改，在[mysqld]下添加配置transaction-isolation=READ-COMMITTED。保存并重启mysql。

¶安装confluence

进入download-archives下载confluence。建议选择一个LTS版本。选择Linux 64 Bit，点击Download。

下载到服务器后，用chmod添加可执行权限，切换到root用户执行安装包即可。安装目录与安装包所在的目录没有关系。第一步，选择o，确认安装。

选择安装模式，1 默认安装，2 自定义安装，3 升级。这里选择1。

最后一步，确认安装。这里给出了几个重要的信息。配置信息和附件都存储在家目录。等待安装完成，服务启动。

安装目录：/opt/atlassian/confluence
家目录：/var/atlassian/application-data/confluence
HTTP端口：8090
RMI端口：8080

¶防火墙

进入宝塔面板，点击左侧的安全，点击添加端口规则，放开8090端口。打开浏览器，输入ip:8090即可访问confluence。

¶破解

¶准备

使用命令systemctl stop confluence停止服务。
下载atlassian-agent.jar并上传到服务器的/var/atlassian/application-data目录，并将文件的所有者和所属组改成confluence。修改文件/opt/atlassian/confluence/bin/setenv.sh，在文件末尾添加以下内容。

1	export JAVA_OPTS="-javaagent:/var/atlassian/application-data/atlassian-agent.jar ${JAVA_OPTS}"

使用命令systemctl start confluence启动服务。使用命令systemctl status confluence确认服务是否启动成功。如果启动失败，请检查setenv.sh文件是否有语法错误。

¶生成序列号

打开浏览器，输入ip:8090访问confluence，这里选择产品安装。

获取应用，根据实际情况勾选。建议不要勾选。

复制服务器ID。

进入服务器命令行，使用如下命令生成序列号。相关参数需要替换成实际的值。将生成的序列号填入网页，点击下一步，即可完成破解。

1 2	cd /var/atlassian/application-data java -jar atlassian-agent.jar -p conf -m aaa@bbb.com -n my_name -o http://ip -s ABCD-1234-EFGH-5678

-p product, conf: confluence
-m email
-n name
-o organisation
-s server id

¶连接mysql数据库

数据库选择mysql，由于缺少mysql驱动，这里需要到dev.mysql.com下载MySQL驱动程序。

图示版本号确认是可以的。点击下载，将解压之后的mysql-connector-java-8.0.22.jar移动到/opt/atlassian/confluence/confluence/WEB-INF/lib目录。注意：将文件的所有者和所属组都更改为confluence。

systemctl restart confluence重启服务，重启好之后，刷新网页，填入创建数据库步骤记录下来的信息。如果遇到如下两个错误，请检查修改数据库排序规则和修改数据库隔离级别。

¶完成安装

数据库连接成功后，点击空白站点，完成安装。

¶使用

¶基本设置

默认URL、邮件服务器等。

¶破解插件

遇到付费插件时，点击立即购买，然后点击接受&安装。

安装好之后进入插件的管理界面，复制应用密钥。然后使用下面的命令生成许可证。注意-p后面是接应用密钥。

1 2	cd /var/atlassian/application-data java -jar atlassian-agent.jar -p com.mxgraph.confluence.plugins.diagramly -m aaa@bbb.com -n my_name -o http://ip -s ABCD-1234-EFGH-5678

¶维护

数据的备份与还原，迁移，以及软件升级。

¶备份

备份分为confluence备份和数据备份。

¶confluence自动备份

使用管理员账号进入一般配置，在预定作业->备份系统，编辑备份系统的日程表。

点击左侧的每日备份管理，可以设置备份文件的文件名，是否备份附件，备份路径。务必确认confluence用户在备份路径有写入的权限，否则不会产生备份文件。

自定义备份路径

默认备份路径不可以修改。如果需要自定义备份路径，修改文件<confluence-home>/confluence.cfg.xml，将以下内容修改为true，重启confluence服务即可修改备份路径。

1	<property name="admin.ui.allow.daily.backup.custom.location">true</property>

¶confluence手工备份

进入一般配置，点击左侧的备份与还原，可以手工导出整个网站。

¶数据库备份

数据库备份借助宝塔的定时任务完成。

¶还原

¶confluence还原

假如confluence奔溃了，无法访问了。停止confluence服务。将家目录/var/atlassian/application-data/confluence移动为/var/atlassian/application-data/confluence.bak，启动confluence服务。由于家目录为空，访问confluence会重新进入配置流程，进入到下图所示的步骤时，选择从备份还原站点。

¶数据库还原

宝塔的数据库管理页面，以及phpmyadmin均可以导入数据包备份文件并还原。

¶迁移

可以参考官方文档Migrating Confluence Between Servers。翻译如下：

在新服务器安装confluce
旧服务器和新服务器都停止confluence服务
复制mysql驱动到新服务器
删除新服务器的家目录，拷贝旧服务器的家目录到新服务器
一些其他的必要修改
<confluence-install>/conf/server.xml从旧服务器复制到新服务器
配置数据库连接
新服务器启动服务，进入一般设置，添加license。

官方给的步骤可以确保server id不变，所以这么复杂。由于是破解版，所以server id变了也没关系，重新生成一个即可。步骤可以简化为：

旧服务器强制触发一次备份
在新服务器安装
最后一步选择从备份文件还原

¶升级

进入一般配置，点击左侧的升级规划，可以下载升级步骤，按照步骤操作即可。建议升级之前，进入定时任务，强制执行一次备份。如果服务器是虚拟机，也可以拍一个快照。