Confluence跨大版本升级记录

初始版本7.4.18最终升级到了目前的最新版本8.7.1，在升级过程中遇到了很多问题，庆幸的是最后都解决了，记录一下。

背景

初始环境：

OS：CentOS8.5

DB：10.8.8-MariaDB

Confluence：7.4.18

公司使用的这个平台很多年了，从起初Windows server+SqlServer+Confluence6.x架构慢慢升到7.4.18，之前被勒索病毒入侵过，搞过P2V从物理机迁到虚机上过，从Windows迁到Linux过；

太多心酸，最终保护的就是数据，虽然之前因备份不及时线上数据被加密丢失过几个月的数据。

最近上级安全部门又扫描到有漏洞，需要立即整改，安全同事迫于压力只能先封停外网访问，这个时间就要研究版本升级问题；

之前我也尝试过从7.4.18升级至7.13.x版本，没成功，所以一直在用7.4.18，期间遇到漏洞就找Atlassian官方相关说明，不敢做版本升级了；

这次听说其他部门有从6.x升级到最新8.7.1版本的成功案例，也请教了他们，最终解决了升级中的问题。

升级

0x00 由于数据量大，所以我升级都是先安装部署新版本的环境，然后再将附件目录数据同步到新环境的附件目录，然后将老环境的数据库备份出来，在新环境上还原数据库；

         之前6.x升级到7.x都能正常升级，从7.4.x升级到7.13.x时总是报数据库的问题，也就是数据库的表结构有变化。

1、之前使用的破解授权，大佬说遇到过破解的jira升级时，数据库乱码，解决方法是将破解授权改为使用授权；

2、大佬还提了一个问题是，我之前用的MariaDB，后面的新版本不支持MariaDB了，需要改成MySQL；

下面记录一下我做的尝试：

A、从7.4.18的10.8.8-MariaDB备份数据，到7.13.20版本的MariaDB上恢复数据，报错

B、从7.4.18备份站点的xml包恢复到7.13.20环境，报错

C、将备份的7.4.18的数据库升级到MySQL8.0.35，再将线上7.4.18 MariaDB的数据备份再MySQL上恢复，成功了

D、再从备份的7.4.18+MySQL的数据备份，在新环境.13.20+MySQL 8.0.35上恢复数据，成功，但管理用户时报错，报错说有个列名external_id找不到，这里找了经常操作数据库的同事给查看了表结构，找到新版本数据库cwd_group表里增加了一列叫external_id

在新版本里的环境里查看external_id列属性，表里是否有数据，庆幸的时只添加了列名并没有数据，所以在新环境中在cwd_group表里添加上这个列名就解决了这个问题；

这里有个查询所有列名的方法在information_schema数据库里查询columns表：

E、尝试升级到比较新的7.19.17版本，恢复数据库都能正常恢复，但是启动服务时会报错，通过查看日志文件atlassian-confluence.log，主要有如下几种原因

a、缺少列名，参考上面的方法，先在新环境的数据库查询需要的列是在哪个表，在对应的表里添加相应的列就可以。

b、表已存在，不能再创建，这种看了下这个表里其实没有数据，所以可以直接删掉

c、数据库里保存的baseurl与实际的IP不一致，需要改数据库里的baseurl(8.7.1版本里这个报错不会造成起不来服务，可以启动了服务在页面上改)

查询数据库里的baseurl

select BANDANAVALUE
from BANDANA
where BANDANACONTEXT = '_GLOBAL'
and BANDANAKEY = 'atlassian.confluence.settings';

修改数据库里的baseurl

update BANDANA 
set BANDANAVALUE = replace(BANDANAVALUE, 'http://old_url', 'http://new_url') 
where BANDANACONTEXT = '_GLOBAL' 
and BANDANAKEY = 'atlassian.confluence.settings';

F、从7.19.17到8.7.1版本，Confluence的附件存储方式也做了升级，从以往的ver003升级到了v4，现象就是7.xx版本的附件目录名称为ver003，8.xx版本的附件目录为v4

Confluence8.xx版本自己做了v3-to-v4的执行任务，触发的条件就是在附件目录存在ver003目录，服务启动后会自己迁移到v4目录下，并记录日志

分层文件系统附件存储 |Confluence 数据中心和服务器 8.7 |Atlassian 文档

G、升级后，Confluence无法启动，主目录中的内部版本号与数据库中的内部版本号不匹配

Confluence 不会启动，因为主目录中的内部版本号与数据库中的内部版本号不匹配，升级后 |汇合 |Atlassian 文档