admin 管理员组

文章数量: 1103806

Atlassian Confluence搭建

1 基础环境准备

  • Java11
  • MySQL8

一些版本支持情况可以参考

https://confluence.atlassian/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 stringDatabase 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

本文标签: Windows