Atlassian Confluence搭建
1 基础环境准备
- Java11
- MySQL8
一些版本支持情况可以参考
https://confluence.atlassian.com/doc/supported-platforms-207488198.html#SupportedPlatforms-Databases
2 安装步骤
下载安装包,完成基础安装步骤(建议选择Custom Install,可以自己配置路径),记下安装路径。为了防止一些不必要的错误,本次安装路径中无空格、无中文。
C:\Atlassian
安装完成的最后一部,会显示Launching Confluence XXX in Browser
,自动弹出浏览器
选择Production Installation
得到Server ID
,复制记录一下
进入Confluence安装目录,打开cmd,执行stop_service.bat
,停止服务
将atlassian-agent.jar
放到特定目录下,本次为了方便直接将其放到Confluence的bin目录下
编辑文件C:\Atlassian\Confluence\bin\setenv.bat
,在Java配置项部分添加如下语句并保存:
set CATALINA_OPTS=-javaagent:atlassian-agent.jar %CATALINA_OPTS%
进入bin目录,使用atlassian-agent.jar
生成License Key
规则为
java -jar atlassian-agent.jar -p conf -m 邮箱 -n 用户 -o 组织 -s 上面的 ServerID
为了方便复制,直接>> 00.txt
将其输出到文本文档中,得到的内容如下
同样在bin目录下,在cmd中执行start_confluence.bat /fg
可以看到成功通过agent启动confluence
浏览器访问localhost:8090
,输入之前生成的License Key,点击Next
选择My own database
数据库类型选择MySQL
,会提示没有相应的jdbc connector;根据提示去下载
把下载好的connector放到路径下
C:\Atlassian\Confluence\confluence\WEB-INF\lib
重启confluence,注意也要使用bin下的start_confluence.bat,浏览器访问,再次选择MySQL数据库,填写相应信息,选择Test connection。
一般都会报错
3 可能遇到的问题
问题1
SQLState - 42000
Error Code - 1049
java.sql.SQLSyntaxErrorException: Unknown database 'confluence'
解决方式:
登录数据库并创建confluence
数据库
问题2
SQLState - 01S00
java.sql.SQLException: The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property) to use a more specifc time zone value if you want to utilize time zone support.
解决方式:
将Setup type
修改为By connecting string
,Database URL
最后增加?serverTimezone=GMT%2B8
问题3
Collation error
The database collation 'utf8mb4_0900_ai_ci' is not supported by Confluence. You need to use 'utf8_bin, utf8mb4_bin'. Learn more
解决方式:
打开数据库,执行
alter database confluence default collate utf8_bin;
然后重新Test connection即可
问题4
Incorrect isolation level
Your database must use 'READ-COMMITTED' as the default isolation level. Learn more
解决方式:
打开数据库,执行
SET GLOBAL TRANSACTION ISOLATION LEVEL READ COMMITTED;
然后重新Test connection即可
其他错误可以自行百度/谷歌,基本上从数据库里修改配置就可以
4 安装完成
当出现连接成功时,就可以点击Next
了;创建数据库的时间较长,需要稍作等待
数据库创建完成后,出现如下界面,可以选择Example Site
。(看到这一幕,十分感动)
接下来选择管理用户和组的方式,由于没有Jira,所以选第一个
设置用户名和密码
然后就会出现Setup Successful!!!
注意,之后每次启动都需要通过start_confluence.bat /fg