2019年初，一次Confluence迁移升级历程

Atlassian Confluence 从5.7.1升级到 6.14.1

背景

随着时间的推移 用户量不断增长 数据量也越来越大 Confluence最初安装使用的是内存数据库 由于这个技术债务 所需的资源（尤其是内存）越来越大 服务启动所需JVM需求不断增长：4G—8G—12G 曾出现因JVM不足导致系统慢或重启失败的情况 稳定性和性能受到一定程度影响 同时版本也比较落后 无法使用一些新特性 于是乎 决定对Confluence进行升级迁移

目标

Confluence迁移升级主要有以下几个目的：

1. 将内存数据库切换为Mysql，降低对机器内存的需求
2. 升级Confluence到最新版本，使用新特性
3. 认证使用LDAP，统一帐号，同时省去注册环节

主要事项

Confluence迁移升级主要事项有：安装、数据迁移、迁移后处理

安装

安装过程比较简单，参考官方文档即可 同时在安装后，配置LDAP方式认证

数据迁移

数据迁移主要是从旧的Confluence导出备份，然后导入到新的Confluence进行还原

在Confluence中有两种备份类型： 站点备份: 在 "管理 "> "备份与恢复" 页面创建备份 单空间备份： 从导出单空间为XML文件创建（在空间高级配置页面）

数据迁移过程遇到的最大问题是：包含emoji表情的xml无法导入到新版本 解决方式是：将备份包解压，然后对其中的entities.xml文件中的emoji表情过滤掉，然后重新生成新的压缩包 因为整个站点备份备份包太大（entities.xml 1.8G），不好进行处理 所以于是采用分治策略：导出每个空间备份，处理掉emoji表情问题，然后每个空间导入还原

迁移过程中旧的Confluence空间只读，迁移之后修改域名指向新的Confluence

迁移后处理

迁移完成后，主要对以下事项进行了处理

• 空间页面历史权限处理
• Confluenc宏中文乱码处理
• 关闭登录验证码
• 修改忘记密码链接
• Confluence和Jira集成

影响

迁移之后，Confluence页面URL的pageid可能会发生变化

参考

1. Confluence官方安装升级文档
2. Confluenc宏乱码解决
3. 修改忘记密码链接
4. Python过滤emoji

(adsbygoogle = window.adsbygoogle || []).push({});