Page tree
Skip to end of metadata
Go to start of metadata

中文标题【整合到其他数据库】


这个文档描述了如何整合你的 Confluence 数据库从你已经存在的数据库上到其他的数据库。这个指南被用来指导你从使用评估数据库转移到使用生产数据库。

大数据量需要第三方的数据库整合工具。

本页面对下面的内容进行了解释和说明:

  • 从嵌入的数据库中移植到支持的外部数据库。
  • 从一个外部数据库中移动到另外的外部数据库,例如从 Oracle 移植到 PostgreSQL (在你数据量不是很大的情况)。
  • 从同一个外部数据库中升级到新的额版本。请注意:如果你只是对现有的运行实例进行升级的话,你不需要整合你的数据。


如果你将你的数据库从一个服务上移动到另外的服务器,你可以修改你的 JDBC 连接 URL。这个配置在 <confluence-home>/confluence.cfg.xml 文件中(如果你使用的是 JDBC 驱动的话);或者你也可以修改你的数据源(如果你是通过数据源进行连接的话)。



数据库整合的限制


注意: Confluence 自带的 XML 方式导出方法并不适用于备份和整合大数据集。这里有一些第三方的数据库工具你可以使用能够帮助你对大数据集进行备份和整合。如果你在选择正确工具的方面需要帮助,或者你需要对整合整个过程需要帮助,你可以联系 Atlassian Experts 来获得相关的指导。


数据库整合

有下面 2 种方法可以帮助你对对数据进行整合,这两种方法在下面的内容中进行描述说明:

  1. 方法 1  是最标准的方法和处理流程。

  2. 如果你整个安装实例的附件超过了 500MB,请使用 方法 2

方法 1:基本流程

步骤 1:对你的插件进行记录


对你近期在 Confluence 中安装和启用的插件进行记录,这你可以在后期对插件进行重新安装或者调整。针对你安装的插件,你需要记录下面的一些内容:

  • 插件名称
  • 版本号
  • 启用或禁用状态。这个对你自己启用禁用 Confluence 的一些模块能够起到帮助作用,能够帮你在后期修改 Confluence 的默认配置。


步骤 2: 备份你的数据

  1. 针对你已经存在的数据,创建一个 XML 备份。请参考  Manually Backing Up the Site 页面中的内容。你需要记录创建的 XML 备份的位置,你需要这个文件在后面导入到 Confluence 使用的新数据库中。
  2. 停止 Confluence。
  3. 复制 Confluence Home 目录。这个能够保证你在备份恢复的时候可能出现错误的重写和数据丢失,能够让你在出现问题的时候重新恢复数据。
  4. 如果你使用的是一个外部数据库,请确保你外部数据库也创建了一个备份。你可以使用外部数据库提供的各种工具来创建这个备份。

步骤 3 :设置新的数据库


为你的新数据库选择数据库设置指南,并且运行这些指南能帮你做下面的一些事情:

  • 安装数据库服务器。
  • 针对数据库服务器对平台和性能进行一些调整。
  • 添加 Confluence 数据库和用户。在这一步的时候记录你使用的数据库用户名和密码。你需要在下一步运行 Confluence 安装向导的时候使用。


步骤 4:在新的位置安装 Confluence(相同的版本号)


现在你需要再次对 Confluence 进行安装,这次安装将会按照在不同的 Home 目录路径和安装路径。

注意:你必须使用和你前期 Confluence 安装完全相同的版本(如果你希望对 Confluence 进行升级,你需要单独进行进行升级)。例如,如果你当前 Confluence 运行的是 5.1.2,你新安装的 Confluence 也必须是 5.1.2 版本。

当运行 Confluence installer 的时候:

  • 选择 自定义安装(Custom Install)。(不要选择升级已经存在的安装实例。)
  • 选择 一个新的安装目录。 这个安装目录是针对你新安装的 Confluence。这个安装目录必须与你当前安装的 Confluence 目录完全不同。
  • 选择 一个新的 home 目录。 这个安装目录是针对你新安装的 Confluence。这个安装目录必须与你当前安装的 Confluence 目录完全不同。


步骤 5 :如果需要的话下载和安装数据库驱动

注意,Confluence 捆绑了一些数据库驱动,如果你选择使用的数据库驱动没有捆绑到 Confluence 中的话,你需要对这些数据库驱动进行安装。请参考数据库设置指南中的内容来设置你的新数据库。如果必要的话,你需要下载和安装新的数据库驱动。


步骤 6:运行 Confluence 安装向导然后拷贝你的数据到新的数据库中


当运行 Confluence 设置向导:

  • 和平常一样输入你的许可证秘钥。
  • 在安装类型中选择 生产安装(Production Installation)
  • 数据类型(Database type)下拉菜单中选择 我自己的数据库(My own database)然后选择你安装使用的数据库。
  • 当弹出需要选择 我自己的数据库(My own database),的时候,你需要选择你新的 数据类型(Database type)
  • 输入你的数据库细节。使用 测试连接(test connection)来确定你的数据库已经被正确的设置了。
  • 在载入内容步骤,选择 从备份中恢复(Restore From Backup)。这个是从你备份的 XML 文件中导入内容到数据库中的步骤,有下面 2 种方法可以访问你备份出来的 XML 文件:
    • 从网络中浏览访问你的 XML 备份文件,然后选择 上传和恢复(Upload and Restore)
    • 可选的,你可以将你的 XML 备份文件上传到你新安装 Confluence 的 home 目录中(<CONFLUENCE-HOME-DIRECTORY>\restore)然后选择 恢复(Restore),针对大的 XML 文件,我们推荐使用这个方法。

说明:如果你选择不在 Confluence 安装过程中对数据进行回复,你可以在安装成功后再将数据进行导入。进入 Confluence 的管理员控制台,然后选择从 XML 备份中恢复。请参考 Site Backup and Restore 页面中的内容。


步骤 7 :重新安装你所有的插件


重新安装没有捆绑到 Confluence 中的插件。

  • 使用与你老的 Confluence 安装一致的插件。
  • 插件创建的数据已经存在在你新安装的 Confluence 了,因为你在对数据库进行备份的时候已经备份出来再 XML 文件中了。


步骤 8 :检查新机器的设置


如果你移动到 Confluence 到不同的服务器上了,你需要检查下面的一些设置:

  • 配置你新的 Base URL,请参考Configuring the Server Base URL.
  • 检查你的应用连接,请参考: Linking to Another Application.
  • 更新为外部站点的针对 Confluence 使用的任何小程序订购。例如,如果你的 Jira 站点订购了 Confluence 小程序,你需要更新你的 JIRA 站点。
  • 检查任何其他消费使用 Confluence 的其他站点。



方法 2:针对有大量附件的运行实例

设置准备

这个方法仅仅针对附件存储在文件系统中。如果你存储附件在数据库中,请参考 Attachment Storage Configuration 文档中的内容来找到如何在 2 种不同的文件存储方式之间进行整合。

步骤 1 :对你的插件进行记录


对你近期在 Confluence 中安装和启用的插件进行记录,这你可以在后期对插件进行重新安装或者调整。针对你安装的插件,你需要记录下面的一些内容:

  • 插件名称
  • 版本号
  • 启用或禁用状态。这个对你自己启用禁用 Confluence 的一些模块能够起到帮助作用,能够帮你在后期修改 Confluence 的默认配置。


步骤 2 :备份你的数据

  1. 针对你已经存在的数据,创建一个 XML 备份。请参考  Manually Backing Up the Site 页面中的内容。你需要记录创建的 XML 备份的位置,你需要这个文件在后面导入到 Confluence 使用的新数据库中。
  2. 停止 Confluence。
  3. 对 Confluence Home 目录中的附件目录进行拷贝(<CONFLUENCE-HOME-DIRECTORY>\attachments)。你需要在后续拷贝你的 Confluence 目录到新的 Confluence 安装实例中。
  4. 如果你使用的是一个外部数据库,请确保你外部数据库也创建了一个备份。你可以使用外部数据库提供的各种工具来创建这个备份。

步骤 3 :设置新数据库


为你的新数据库选择数据库设置指南,并且运行这些指南能帮你做下面的一些事情:

  • 安装数据库服务器。
  • 针对数据库服务器对平台和性能进行一些调整。
  • 添加 Confluence 数据库和用户。在这一步的时候记录你使用的数据库用户名和密码。你需要在下一步运行 Confluence 安装向导的时候使用。


步骤 4:在新的位置安装 Confluence(相同的版本号)


现在你需要再次对 Confluence 进行安装,这次安装将会按照在不同的 Home 目录路径和安装路径。

注意:你必须使用和你前期 Confluence 安装完全相同的版本(如果你希望对 Confluence 进行升级,你需要单独进行进行升级)。例如,如果你当前 Confluence 运行的是 5.1.2,你新安装的 Confluence 也必须是 5.1.2 版本。

当运行 Confluence installer 的时候:

  • 选择 自定义安装(Custom Install)。(不要选择升级已经存在的安装实例。)
  • 选择 一个新的安装目录。 这个安装目录是针对你新安装的 Confluence。这个安装目录必须与你当前安装的 Confluence 目录完全不同。
  • 选择 一个新的 home 目录。 这个安装目录是针对你新安装的 Confluence。这个安装目录必须与你当前安装的 Confluence 目录完全不同。


步骤 5 :如果需要的话下载和安装数据库驱动

注意,Confluence 捆绑了一些数据库驱动,如果你选择使用的数据库驱动没有捆绑到 Confluence 中的话,你需要对这些数据库驱动进行安装。请参考数据库设置指南中的内容来设置你的新数据库。如果必要的话,你需要下载和安装新的数据库驱动。


步骤 6:运行 Confluence 安装向导然后拷贝你的数据到新的数据库中


当运行 Confluence 设置向导:

  • 和平常一样输入你的许可证秘钥。
  • 在安装类型中选择 生产安装(Production Installation)
  • 数据类型(Database type)下拉菜单中选择 我自己的数据库(My own database)然后选择你安装使用的数据库。
  • 当弹出需要选择 我自己的数据库(My own database),的时候,你需要选择你新的 数据类型(Database type)
  • 输入你的数据库细节。使用 测试连接(test connection)来确定你的数据库已经被正确的设置了。
  • 在载入内容步骤,选择 从备份中恢复(Restore From Backup)。这个是从你备份的 XML 文件中导入内容到数据库中的步骤,有下面 2 种方法可以访问你备份出来的 XML 文件:
    • 从网络中浏览访问你的 XML 备份文件,然后选择 上传和恢复(Upload and Restore)
    • 可选的,你可以将你的 XML 备份文件上传到你新安装 Confluence 的 home 目录中(<CONFLUENCE-HOME-DIRECTORY>\restore)然后选择 恢复(Restore),针对大的 XML 文件,我们推荐使用这个方法。

说明:如果你选择不在 Confluence 安装过程中对数据进行回复,你可以在安装成功后再将数据进行导入。进入 Confluence 的管理员控制台,然后选择从 XML 备份中恢复。请参考 Site Backup and Restore 页面中的内容。


步骤 7:拷贝你的所有附件

Copy the contents of the attachments directory (<CONFLUENCE-HOME-DIRECTORY>\attachments) from your old Confluence Home directory to your new Confluence Home directory.

步骤 8 :重新安装你所有的插件


重新安装没有捆绑到 Confluence 中的插件。

  • 使用与你老的 Confluence 安装一致的插件。
  • 插件创建的数据已经存在在你新安装的 Confluence 了,因为你在对数据库进行备份的时候已经备份出来再 XML 文件中了。


步骤 9 :检查新机器的设置


如果你移动到 Confluence 到不同的服务器上了,你需要检查下面的一些设置:

  • 配置你新的 Base URL,请参考Configuring the Server Base URL.
  • 检查你的应用连接,请参考: Linking to Another Application.
  • 更新为外部站点的针对 Confluence 使用的任何小程序订购。例如,如果你的 Jira 站点订购了 Confluence 小程序,你需要更新你的 JIRA 站点。
  • 检查任何其他消费使用 Confluence 的其他站点。



有关你数据库的大小写敏感问题

'Collation' 是数据如何被存储和比较的规则。大小写是否敏感是有关字符集设置的一个方面。其他大小写敏感的方面有 kana (Japanese script)和宽度(单字节对比双字节长度)。

设置一个新的 Confluence 实例

针对新的 Confluence 实例,我们建议在你的 Confluence 中使用大小写敏感的字符集。这个也是绝大多数数据库系统默认使用的字符集。

备注:经过数据库被配置为大小写敏感字符集,Confluence 在将用户名存储到数据库之前,还是将用户名自动完全转换为小写字符。例如用户名 'joebloggs', 'joeBloggs' 和 'JoeBloggs' 在 Confluence 中被认为是同一个用户名。

整合已经存在的 Confluence 到不同数据库

默认的 Confluence 配置使用大小写敏感的字符集。这个也是数据库创建默认的的字符集。如果你正使用这个字符集配置到新的数据库中,我们推荐你在新数据库中也使用大小写敏感字符么。如果你在新数据库中使用的是非大小写敏感的字符集,但是你老的 Confluence 实例使用的是大小写敏感的字符集的话,你可能在导入的时候遇到以一些问题(例如,通过 XML 方式导入)。

问题解决

如果你在 XML 备份和导入的时候遇到问题,请查看 See our troubleshooting guide 中的内容。


  • No labels