Confluence数据迁移及升级(5.9.0升级到6.1.0)

时间:2024-04-11 22:40:53

前言

官网有关备份/恢复Confluence系统数据文档:

 

同一版本迁移到不同服务器

https://confluence.atlassian.com/conf59/migrating-confluence-between-servers-792499892.html

关于Confluence升级

https://confluence.atlassian.com/conf59/upgrading-confluence-792499869.html




1.1同一版本不同服务器数据迁移

在升级或者迁移系统之前,我们需要对系统的数据进行备份。创建一份完整的Confluence系统数据备份,需考虑备份的内容包括:

(1)Confluence备份导出的XML压缩文件;

(2)附件目录下的所有文件;

(3)主目录下的logo文件;

(4)数据库数据备份文件;

这些备份文件的创建方法参见下面文档说明。


1.1.1备份数据库数据(在旧服务器上)

备份数据库数据有两种方法:(1)数据库自带的备份工具;(2)Confluence系统的XML备份程序;(3)手动备份数据库。

对于方法一,为了避免数据并发读写导致可能出现的问题,建议首先停止Confluence服务,如果我们使用的是mysql数据库,则可以使用mysql自带的备份工具mysqldump.exe,使用如下命令备份:

mysqldump -h localhost-u root -p confluence>d:\confluence_back.sql

其中的localhost表示本机(可以使用数据库所在服务器的IP地址),root为连接数据库的用户名称,confluence表示所需备份数据库的名称,d:\confluence_back.sql为备份的文件。该工具的使用说明可以参考:http://dev.mysql.com/doc/refman/5.7/en/mysqldump.html。

对于方法二,具体操作步骤如下:

(1)以系统管理员身份登录Confluence系统;

(2)选择Confluence管理-系统;


Confluence数据迁移及升级(5.9.0升级到6.1.0)

(3)选择“管理”中的“备份与还原”,设置备份文件名称后,点“备份”开始数据备份为XML格式。注明:数据中涉及的那些附件并没有备份,需要参考1.1.2章节内容手工备份。

Confluence数据迁移及升级(5.9.0升级到6.1.0)



对于方法三,具体操作步骤如下

为了避免数据并发读写导致可能出现的问题,建议首先停止Confluence服务\

进入到MySQL数据库,选择confluence表格-右键选择备份/导出-备份数据库,转存为SQL

选择导出的路径-导出-完成即可



建议使用方法一和方法三进行备份。因为在Confluence运行过程中由于数据并发读写的原因,使用方法二备份程序需要Confluence服务运行,不能保证数据备份与数据库一致,而使用数据库自带的备份工具,对于Confluence的依赖小,备份效率高、可靠、避免与系统编码和格式相关的问题。



1.1.2手动备份附件

对于Confluence,附件按照安装时设置的目录保存,例如下图所示:


Confluence数据迁移及升级(5.9.0升级到6.1.0)


上图中D:\Program Files\Atlassian\Application Data\Confluence是Confluence的数据目录,建议完整备份该目录中的数据。

(1)注意:系统附加安装的插件并不包含在备份中,在新系统上恢复数据时需要重新安装这些插件。


1.1.3将数据迁移到新服务器

迁移步骤

(1)在新服务器中下载并安装Confluence与之前的版本相同

(2)Confluence安装成功后,在用户目录里面添加单点登录的目录

Confluence数据迁移及升级(5.9.0升级到6.1.0)



(3)单点登录配置成功后,以系统管理员身份登录-管理-备份与还原,将旧服务器上备份的xml文件复制到Confluence主目录下的restore目录中,选中文件,点击还原即可,如下图所示

Confluence数据迁移及升级(5.9.0升级到6.1.0)


(4)数据导入成功如下图所示

Confluence数据迁移及升级(5.9.0升级到6.1.0)



(5)数据导入成功后,需要重新登录,即可看到导入的数据

Confluence数据迁移及升级(5.9.0升级到6.1.0)


由此,Confluence数据迁移成功!


1.2 Confluence本地升级

1.2.1升级须知

(1)检查licence是否过期,(由于我们使用的是**版,在安装时也必须是**版的license或是在有效期的license,到时替换**包即可)

(2)检查Java版本,应用程序服务器,操作系统,数据库及浏览器版本是否支持,参考支持平台的声明,确保满足最新的需求。

     参考网址:https://confluence.atlassian.com/conf59/supported-platforms-792499889.html

(3)检查数据库的最新数据库指南,确保配置的正确性。

     参考网址:https://confluence.atlassian.com/conf59/database-configuration-792499572.html

(4)检查插件的是否兼容。

(5)确定升级的版本及要安装的路径。

(6)确定升级的方式,取决于您的需求。

(7)先在测试环境中做好测试,测试无误后再在正式的环境中升级



1.2.2升级步骤

一、备份(重点:必须备份且完整无误)

(1)备份数据库(可参照1.1.1如上所述)

(2)备份Confluence主目录(例如:D:\ProgramFiles\Atlassian\Application Data\Confluence)

(3)备份Confluence安装目录(例如:D:\ProgramFiles\Atlassian\Confluence)

 

 

二、升级

(1)下载所需要的安装版本(我们目前升级的版本为6.1.1)

(2)关闭Confluence现有的服务

Confluence数据迁移及升级(5.9.0升级到6.1.0)

(3)安装要升级的版本

Confluence数据迁移及升级(5.9.0升级到6.1.0)

(4)选择升级的路径


Confluence数据迁移及升级(5.9.0升级到6.1.0)


(5)列表中提示升级过程中修改的相关文件


Confluence数据迁移及升级(5.9.0升级到6.1.0)


(6)升级过程

(注:升级前页面会显示是否备份confluence主目录,由于之前已备份,所有在升级途中无需再备份,可选择不勾选)

Confluence数据迁移及升级(5.9.0升级到6.1.0)


(7)勾选再点击下一步

Confluence数据迁移及升级(5.9.0升级到6.1.0)


(8)安装完成后,暂不选打开浏览器,点击完成

Confluence数据迁移及升级(5.9.0升级到6.1.0)


(9)关闭confluence服务

Confluence数据迁移及升级(5.9.0升级到6.1.0)

(10)替换**包,路径在安装目录下Confluence-confluence-WEB-INF-lib(尤其重要)

Confluence数据迁移及升级(5.9.0升级到6.1.0)


(11)替换之前配置好的单点登录文件

Confluence数据迁移及升级(5.9.0升级到6.1.0)

(12)注意升级后confluence使用的是本身自带的登录信息,需要手动改为单点登录,在安装目录下Confluence-confluence-WEB-INF-classes-seraph-config.xml如下图注意升级后confluence使用的是本身自带的登录信息,需要手动改为单点登录,在安装目录下Confluence-confluence-WEB-INF-classes-seraph-config.xml如下图

Confluence数据迁移及升级(5.9.0升级到6.1.0)

再开启服务,Confluence升级成功!


1.3 升级途中出现的问题

(1)当Confluence升级完毕,未替换**包时,页面无法显示登录界面,且日志也会提示报错信息,如下图:

 

Confluence数据迁移及升级(5.9.0升级到6.1.0)

注:当升级成功后应先关闭服务,替换**包,才能成功启动Confluence系统