Confluence6+mysql5.7安装避坑详细记录

目录

一、前言

二、下载与安装

1、版本和安装环境

2、安装数据库

3、配置数据库

4、安装confluence

三、Pj confluence

1、选择语言和产品安装

2、Pj

3、上传mysql驱动

4、重启Confluence服务继续安装

四、Confluence重启卸载方法

重启方法

方法一

方法二

卸载Confluence

---

一、前言

confluence可用于个人或多人知识存储和文章分享，有团队维护的，详情可参考confluence官网。

以下操作过程，mysql5.7数据库、数据库配置方法、数据库驱动confluence7.4也支持，按照下面的操作过程confluence7.4我也搭建成功了，但Pj包我用的7的。confluence8我没试过。

二、下载与安装

1、版本和安装环境

centos 7
jdk 8 （用于Pj jar文件，用linux和windows Pj 都行，为了方便我用的windows）
mysql 5.7  （confluence对可是配数据库的版本有要求的）
Confluence 6.8.5

2、安装数据库

confluence对可适配数据库有要求，这是第一个坎！

confluence支持多种的数据库，为了方便，我这里用的是mysql版本5.7，Confluence本身是没有集成mysql驱动的，所以还需要连接mysql的jar包mysql-connector。

1）安装mysql5.7

现在高版本的centos和kali中mysql的版本也很高，但不适配confluence6使用，下边这篇文章可用于安装mysql5.7的参考：[亲测有效]CentOS7下安装mysql5.7-CSDN博客https://blog.csdn.net/huayimy/article/details/135753769?csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22135753769%22%2C%22source%22%3A%22huayimy%22%7D

2）安装mysql驱动

下载路径：https://dev.mysql.com/downloads/connector/j/5.1.html
选择对应的linux版本信息，再选择5.1.46版本，下面这张图是下载包中的内容，mysql...bin.jar这个文件是驱动后面要用。

3、配置数据库

最好先对数据库进行配置，官网有对数据库详细要求的具体配置内容

Database Setup For MySQL | Confluence Data Center and Server 8.7 | Atlassian Documentationhttps://confluence.atlassian.com/doc/database-setup-for-mysql-128747.html

注：我配置官网的数据库连接没成功，配置下边的连接成功了

1）mysql配置文件为/etc/my.cnf，在[mysqld]标签下添加（安装完confluence后再配置也不会报错）

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

2）接着配置文件/etc/my.cnf.d/client.cnf，在[client]中添加

default-character-set=utf8

3）然后配置文件/etc/my.cnf.d/mysql-clients.cnf，在[mysql]中添加

default-character-set=utf8

 注：我是用centos7本地安装的mysql，没有2）和3）这两个文件，后面启动时也没报错影响

4）最后重启mysqld，并登陆mysqld查看字符集 

service mysqld restart
mysql -uroot -p
mysqld [(none)]> show variables like "%character%";show variables like "%collation%";

5）为Confluence创建对应的数据库、用户名和密码

若有这个报错  ERROR 2002 (HY000: Can’t connect to local MySQL server through socket /var/lib/mysql/mysql.sock  可参考这篇文章：[已解决]ERROR 2002 (HY000: Can’t connect to local MySQL server through socket /var/lib/mysql/mysql.sock-CSDN博客https://blog.csdn.net/huayimy/article/details/135740534?spm=1001.2014.3001.5502若有这个报错  ERROR 1290 (HY000): The MySQL server is running with the --skip-grant-tables 可参考这篇文章：[已解决]ERROR 1290 (HY000): The MySQL server is running with the --skip-grant-tables 成功解决报错-CSDN博客https://blog.csdn.net/huayimy/article/details/135743695?spm=1001.2014.3001.5502

mysqld [(none)]> create database confluence default character set utf8 collate utf8_bin;
mysqld [(none)]> grant all on confluence.* to 'confluence'@'localhost' identified by 'Confluence@123';
mysqld [(none)]> flush privileges;

这里要注意有个坑一定要提前填上！！这是第二个坎！！

6）关闭mysql的ssl认证

MySQL默认SSL认证设置是开启的，必须关闭此数据库的ssl认证或者关闭所有ssl认证，不然会一直显示连接失败！！

具体操作可参考这篇文章：

[已解决]mysql关闭SSL功能和永久关闭SSL设置-CSDN博客https://blog.csdn.net/huayimy/article/details/135750395?spm=1001.2014.3001.5502

4、安装confluence

1）下载confluence

官网：
https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-6.8.5-x64.bin
https://www.atlassian.com/software/confluence/downloads/binary/atlassian-confluence-6.8.5-x64.exe

注：这里建议下载6.8.5，高版本我之前测试没成功（下次试一下7版本的，如成功了我再过来补充）

2）下载Pj工具（后面Pj时用）

https://www.tracymc.cn/wp-content/uploads/2018/08/confluence%E7%A0%B4%E8%A7%A3%E5%B7%A5%E5%85%B7-6.8.5.ziphttps://www.tracymc.cn/wp-content/uploads/2018/08/confluence%E7%A0%B4%E8%A7%A3%E5%B7%A5%E5%85%B7-6.8.5.zip

3）安装

先给此文件赋予777权限，方便运行

chmod +x atlassian-confluence-6.8.5-x64.bin

运行文件得到下面的内容，需要注意记录好Confluence的安装路径（我使用的默认路径，省事），
默认程序：/opt/atlassian/confluence
默认数据：/var/atlassian/application-data/confluence

注：如果最后找不到安装路径了，就用find命令找，然后pwd即为安装路径

在安装的最后，会问Start Confluence now?选n或y都行，因为Pj时也要重启confluence服务的。

# 执行安装程序，进行安装：./atlassian-confluence-6.8.5-x64.bin

Unpacking JRE ...Starting Installer ...

# o确定安装，c取消This will install Confluence 6.8.5 on your computer.

OK [o, Enter], Cancel [c]

o

Click Next to continue, or Cancel to exit Setup.

# 选择1是使用默认安装路径，2为自定义安装（建议选择默认路径方便）Choose the appropriate installation or upgrade option.Please choose one of the following:Express Install (uses default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing Confluence installation [3]1

# 指定安装的目录，会自动创建，不输入直接回车就是使用默认路径Select the folder where you would like Confluence 6.8.5 to be installed,then click Next.Where should Confluence 6.8.5 be installed?[/opt/atlassian/confluence]/usr/local/atlassian/confluence

# 使用默认的路径存储数据Default location for Confluence data[/var/atlassian/application-data/confluence]

i

# 使用默认的端口，8090和8000Configure which ports Confluence will use.Confluence requires two TCP ports that are not being used by any other

applications on this machine. The HTTP port is where you will accessConfluence through your browser. The Control port is used to Startup andShutdown Confluence.Use default ports (HTTP: 8090, Control: 8000) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]1

# 安装为后台进程，可后台运行Confluence can be run in the background.You may choose to run Confluence as a service, which means it will start

automatically whenever the computer restarts.Install Confluence as Service?Yes [y, Enter], No [n]

y

Extracting files ...                                                           

Please wait a few moments while we configure Confluence.

# 是否启动ConfluenceInstallation of Confluence 6.8.5 is completeStart Confluence now?Yes [y, Enter], No [n]

y

Please wait a few moments while Confluence starts up.Launching Confluence ...

# 安装完成，访问本机的8090端口进行web端安装Installation of Confluence 6.8.5 is completeYour installation of Confluence 6.8.5 is now ready and can be accessed via

your browser.Confluence 6.8.5 can be accessed at http://localhost:8090Finishing installation ...

# 开放防火墙端口（也可以直接把防火墙用systemctl关闭）

firewall-cmd --add-port=8090/tcp --permanent

firewall-cmd --add-port=8000/tcp --permanent

firewall-cmd --reload

三、Pj confluence

查看服务是否启动：

[root@node1 ~]# ss -tnl|grep 8090

LISTEN     0      10                       :::8090                    :::*

浏览器里输入http://$IP:8090，访问confluence，然后按照下面的步骤继续安装confluence:

1、选择语言和产品安装

选择中文

稍等一下语言更换完之后，选择产品安装，然后点击下一步

插件先不选，直接下一步

记录下server ID，后面进行Pj

2、Pj

1）先进入confluence安装目录/usr/local/atlassian/confluence关闭confluence服务

（若没有可能在这里./opt/atlassian/confluence/bin/）

bin/stop-confluence.sh    # 关闭confluence

./stop-confluence.sh

2）将/usr/local/atlassian/confluence/confluence/WEB-INF/lib/目录下的一个atlassian-extras-decoder-v2-3.3.0.jar包拿出来放到Pj软件所在的目录中，将其改名为atlassian-extras-2.4.jar

然后在jdk所在主机内进行Pj操作（我用的win10）：
① 打开下载的Pj工具，运行confluence_keygen.jar
②将记录的server ID填入，Name随便填
③点击.gen生成key，将key记录下来
④点击patch，选择刚下传到本地的atlassian-extras-2.4.jar文件进行Pj。

注：一定要按照要求更改名称，不然Pj工具不认jar文件。

​

然后导入jar文件生成Pj版的jar文件

​

3）Pj完成后，将Pj后的文件atlassian-extras-2.4.jar更改为原来的名字，再传回服务器（记得先删掉confluence中的原文件）

Pj目录详情如下

3、上传mysql驱动

解压后先将mysql-connector-java-5.1.46-bin.jar赋予777权限，以防后面报错，再上传到服务器上，放到confluence的lib目录下/usr/local/atlassian/confluence/lib/

cp mysql-connector-java-5.1.46-bin.jar /usr/local/atlassian/confluence/lib/
chmod 777 mysql-connector-java-5.1.46-bin.jar
#以防后面报错，直接给可执行权限

4、重启Confluence服务继续安装

完成上述步骤后，重启confluence，会回到输入key的界面，输入上面记录的key，点击下一步

注：这步中的重启和第一步中的关闭，必须是进到对应的目录中不能使用systemctl或service，因为还没有安装成功呢。所以confluence的安装路径一定要记住。

​

然后进行配置数据库：我选择的是我自己的数据库（同一个服务器搭建的），这里需要对数据库进行一些配置。

​

在测试成功后，下一步比较慢，需要往数据库写好多表。

​

或者

​

推荐使用示范站点，先熟悉Confluence，然后再自行进行设置

​

用户管理可以选择与jira进行集成，否则还是选择第一个自己管理用户和用户组。

​

配置系统管理员账号

​

​

四、Confluence重启卸载方法

Confluence日志:/usr/local/atlassian/confluence/logs/catalina.out

重启方法

以下为linux的启动服务方法，亲测有效

方法一

使用service或者systemctl都可以，这个方法用于成功安装完confluence之后，在安装过程中的重启不适用
关闭服务

service confluence stop

启动服务

service confluence start

方法二

进入安装目录
关闭服务

/usr/local/atlassian/confluence/bin/stop-confluence.sh

启动服务

/usr/local/atlassian/confluence/bin/start-confluence.sh

卸载Confluence

重装时使用

进入安装目录下，运行uninstall

/usr/local/atlassian/confluence/uninstall

然后手动删除两个路径的文件

rm -rf /usr/local/atlassian/confluence/ /var/atlassian/confluence/

参考：

https://blog.csdn.net/qq_43665254/article/details/111170432

https://www.tracymc.cn/archives/1507