前言
官网有关备份/恢复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管理-系统;(3)选择“管理”中的“备份与还原”,设置备份文件名称后,点“备份”开始数据备份为XML格式。注明:数据中涉及的那些附件并没有备份,需要参考1.1.2章节内容手工备份。
对于方法三,具体操作步骤如下
为了避免数据并发读写导致可能出现的问题,建议首先停止Confluence服务\
进入到MySQL数据库,选择confluence表格-右键选择备份/导出-备份数据库,转存为SQL选择导出的路径-导出-完成即可
建议使用方法一和方法三进行备份。因为在Confluence运行过程中由于数据并发读写的原因,使用方法二备份程序需要Confluence服务运行,不能保证数据备份与数据库一致,而使用数据库自带的备份工具,对于Confluence的依赖小,备份效率高、可靠、避免与系统编码和格式相关的问题。
1.1.2手动备份附件
对于Confluence,附件按照安装时设置的目录保存,例如下图所示:
上图中D:\Program Files\Atlassian\Application Data\Confluence是Confluence的数据目录,建议完整备份该目录中的数据。
(1)注意:系统附加安装的插件并不包含在备份中,在新系统上恢复数据时需要重新安装这些插件。
1.1.3将数据迁移到新服务器
迁移步骤
(1)在新服务器中下载并安装Confluence与之前的版本相同
(2)Confluence安装成功后,在用户目录里面添加单点登录的目录
(3)单点登录配置成功后,以系统管理员身份登录-管理-备份与还原,将旧服务器上备份的xml文件复制到Confluence主目录下的restore目录中,选中文件,点击还原即可,如下图所示
(4)数据导入成功如下图所示
(5)数据导入成功后,需要重新登录,即可看到导入的数据
由此,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现有的服务
(3)安装要升级的版本
(4)选择升级的路径
(5)列表中提示升级过程中修改的相关文件
(6)升级过程
(注:升级前页面会显示是否备份confluence主目录,由于之前已备份,所有在升级途中无需再备份,可选择不勾选)
(7)勾选再点击下一步
(8)安装完成后,暂不选打开浏览器,点击完成
(9)关闭confluence服务
(10)替换**包,路径在安装目录下Confluence-confluence-WEB-INF-lib(尤其重要)
(11)替换之前配置好的单点登录文件
(12)注意升级后confluence使用的是本身自带的登录信息,需要手动改为单点登录,在安装目录下Confluence-confluence-WEB-INF-classes-seraph-config.xml如下图注意升级后confluence使用的是本身自带的登录信息,需要手动改为单点登录,在安装目录下Confluence-confluence-WEB-INF-classes-seraph-config.xml如下图
再开启服务,Confluence升级成功!
1.3 升级途中出现的问题
(1)当Confluence升级完毕,未替换**包时,页面无法显示登录界面,且日志也会提示报错信息,如下图:
注:当升级成功后应先关闭服务,替换**包,才能成功启动Confluence系统