确定 Confluence 在数据库连接池中校验数据库连接： 停止 Confluence。 编辑 <home-directory>confluence.cfg.xml 文件。 针对你特定的数据库，插入下面属性配置信息。 针对 PostgreSQL，SQL Server，和 MySQL <property name="hibernate.c3p0.validate">true</property> <property name="hibernate.c3p0.preferredTestQuery">select 1</property> 针对 Oracle <property name="hibernate.c3p0.validate">true</property> <property name="hibernate.c3p0.preferredTestQuery">select 1 from dual</property> 保存 confluence.cfg.xml 如果你使用 Confluence 5.10.3 或者早期版本，你需要添加下面的内容到你的 system property 来校验你的数据库。 例如： -Dc3p0.preferredTestQuery="select 1" 重启 Confluence. 你应该可以从中断的数据库连接中重新获得所有的数据库连接而不需要重启 Confluence。   https://www.cwiki.us/display/CONFLUENCEWIKI/Surviving+Database+Connection+Closures

不同的数据库通常要求不同的 SQL 校验查询。校验查询通常需要尽可能的简单，这个查询在链接从数据库连接池中取出的时候都会被执行一次。 针对不同的数据库类型，我们推荐先的校验查询 SQL： MySQL select 1 Microsoft SQL Server select 1 Oracle select 1 from dual PostgreSQL select 1   https://www.cwiki.us/display/CONFLUENCEWIKI/Surviving+Database+Connection+Closures

当数据库服务器进行重启或者因为网络问题导致连接中断。所有在数据库连接池中的连接都会被中断。希望处理这个问题，通常需要 Confluence 进行重启。 但是，数据库连接池中的连接可以通过运行 SQL 查询来进行校验。如果在数据库连接池中的连接因为某种原因被中断，通常可以通过在连接池中创建一新的连接来解决。 希望达到这个目的，Confluence 会为你的数据库连接运行校验 SQL。这个配置在新的 Confluence 安装中是默认启动的（Confluence 6.5 及后续版本）。但是如果你是从老的 Confluence 升级上来的话，你可以通过下面的步骤来手动启用这个配置。   https://www.cwiki.us/display/CONFLUENCEWIKI/Surviving+Database+Connection+Closures

如果数据库的查询时间太长同时你的应用程序显示没有响应，你可以配置数据库的查询超时时间。在默认情况下 Confluence 没有超时时间。希望配置数据库查询超时时间，在你的测试服务器上进行下面的操作： 1. 关闭 Confluence。 2. 从 confluence-x.x.x.jar 文件中解压出 databaseSubsystemContext.xml。这个文件在 confluence/WEB-INF/lib/，同时拷贝到 confluence/WEB-INF/classes/ 目录下面。 3. 编辑 confluence/WEB-INF/classes/databaseSubsystemContext.xml 文件，添加 defaultTimeout 属性到"transactionManager" bean 中： <bean id="tenantedTransactionManager" class="org.springframework.orm.hibernate.HibernateTransactionManager" plugin:available="true">         <property name="sessionFactory" ref="sessionFactory"/>         <property name="defaultTimeout" value="120"/>     </bean> 超时的时间默认单位为秒，当查询时间超过这个设置时间的话，将会强制终止查询。在一些情况下 Confluence 没有捕获这个错误，你将可能在 Confluence 中看到错误信息界面。 4. 重启 Confluence。 一旦查询超时时间在你的测试服务器上能够正常工作了，你可以将这个配置整合到你的生产服务器上。 在你对 Confluence 进行升级的时候，你需要重复上面的操作。同时  databaseSubsystemContext.xml 文件可能根据版本的不同而修改。   https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+database+query+timeout

针对已经存在的 Confluence 安装，如果你安装的 Confluence 版本是 6.4 或者早期的版本，我们在安装的时候没有检查你数据库的字符设置。 如果你的数据库当前没有被配置使用 UTF-8 编码（或者与 UTF-8 相同的编码，例如在 Oracle 中使用的 AL32UTF8 编码）： 当你在使用 Confluence 的时候你可能会看到健康检查的警告 你可能在升级 Confluence 后不能启动 Confluence 如果这个问题出现了，你需要修改你已经存在数据库使用的字符集为 UTF-8，有关字符集的修改针对不同的数据修改方法不同。 请参考 Troubleshooting Character Encodings 页面来获得有关字符集问题的处理。 MySQL 请参考 How to Fix the Collation and Character Set of a MySQL Database 页面来获得在你数据库中修改字符的详细信息。你需要确定的字符集是正确的。 Microsoft SQL Server 请参考 How to fix the collation of a Microsoft SQL Server Confluence database 页面来获得在你对数据库字符进行修改的时候需要的详细信息。 PostgreSQL  如果你使用的 PostgreSQL 数据库，最好的办法是重新创建你的数据库。 请参考 Database Setup for PostgreSQL 页面中的内容来如何创建的数据库，并且使用正确的字符集。请参考 Migrating to Another Database 页面中的内容来对数据库进行合并。 Oracle 如果你使用的 Oracle 数据库，最好的办法是重新创建你的数据库。 请参考 Database Setup for Oracle 页面中的内容来如何创建的数据库，并且使用正确的字符集。请参考 Migrating to Another Database 页面中的内容来对数据库进行合并。   https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+Database+Character+Encoding

Confluence 和你的数据库必须配置使用相同的字符集。 Confluence 使用 UTF-8 字符集编码，所以你的数据库也必须配置为使用 UTF-8 （或者与 UTF-8 相同的编码，例如在 Oracle 中使用的 AL32UTF8 编码）。   当你在第一次安装 Confluence 的时候，你需要考虑下面的的几个位置配置使用不同的字符集： 当你创建数据库的时候。 当你使用 JDBC 字符串连接数据库时候配置的连接字符串，或者是你使用的数据源（如果你在安装 Confluence 的时候使用的是简单配置模式，安装向导将会自动帮你配置）。 Confluence 安装向导将会在安装的时候对你的字符集进行校验，如果出现问题，安装向导将会对你弹出警告信息。这个能够保证让你在后续的配置和运行中不会出现问题，相对后期进行调整，现在就把问题解决要容易得多，当你有数据在数据库中进行存储的时候再进行字符集调整就会比较麻烦了。 针对 Confluence 支持的每一个数据库如何进行字符集调整的指南如下，当你在创建数据库的时候请参考下面的指南： Database Setup for PostgreSQL Database Setup For MySQL Database Setup for SQL Server Database Setup for Oracle https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+Database+Character+Encoding

'Collation' 是数据如何被存储和比较的规则。大小写是否敏感是有关字符集设置的一个方面。其他大小写敏感的方面有 kana （Japanese script）和宽度（单字节对比双字节长度）。 设置一个新的 Confluence 实例 针对新的 Confluence 实例，我们建议在你的 Confluence 中使用大小写敏感的字符集。这个也是绝大多数数据库系统默认使用的字符集。 备注：经过数据库被配置为大小写敏感字符集，Confluence 在将用户名存储到数据库之前，还是将用户名自动完全转换为小写字符。例如用户名 'joebloggs', 'joeBloggs' 和 'JoeBloggs' 在 Confluence 中被认为是同一个用户名。 整合已经存在的 Confluence 到不同数据库 默认的 Confluence 配置使用大小写敏感的字符集。这个也是数据库创建默认的的字符集。如果你正使用这个字符集配置到新的数据库中，我们推荐你在新数据库中也使用大小写敏感字符么。如果你在新数据库中使用的是非大小写敏感的字符集，但是你老的 Confluence 实例使用的是大小写敏感的字符集的话，你可能在导入的时候遇到以一些问题（例如，通过 XML 方式导入）。   https://www.cwiki.us/display/CONFLUENCEWIKI/Migrating+to+Another+Database

设置准备 这个方法仅仅针对附件存储在文件系统中。如果你存储附件在数据库中，请参考 Attachment Storage Configuration 文档中的内容来找到如何在 2 种不同的文件存储方式之间进行整合。 步骤 1 ：对你的插件进行记录 对你近期在 Confluence 中安装和启用的插件进行记录，这你可以在后期对插件进行重新安装或者调整。针对你安装的插件，你需要记录下面的一些内容： 插件名称 版本号 启用或禁用状态。这个对你自己启用禁用 Confluence 的一些模块能够起到帮助作用，能够帮你在后期修改 Confluence 的默认配置。 步骤 2 ：备份你的数据 针对你已经存在的数据，创建一个 XML 备份。请参考  Manually Backing Up the Site 页面中的内容。你需要记录创建的 XML 备份的位置，你需要这个文件在后面导入到 Confluence 使用的新数据库中。 停止 Confluence。 对 Confluence Home 目录中的附件目录进行拷贝（<CONFLUENCE-HOME-DIRECTORY>\attachments）。你需要在后续拷贝你的 Confluence 目录到新的 Confluence 安装实例中。 如果你使用的是一个外部数据库，请确保你外部数据库也创建了一个备份。你可以使用外部数据库提供的各种工具来创建这个备份。 步骤 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 站点。 https://www.cwiki.us/display/CONFLUENCEWIKI/Migrating+to+Another+Database

步骤 1：对你的插件进行记录 对你近期在 Confluence 中安装和启用的插件进行记录，这你可以在后期对插件进行重新安装或者调整。针对你安装的插件，你需要记录下面的一些内容： 插件名称 版本号 启用或禁用状态。这个对你自己启用禁用 Confluence 的一些模块能够起到帮助作用，能够帮你在后期修改 Confluence 的默认配置。 步骤 2： 备份你的数据 针对你已经存在的数据，创建一个 XML 备份。请参考  Manually Backing Up the Site 页面中的内容。你需要记录创建的 XML 备份的位置，你需要这个文件在后面导入到 Confluence 使用的新数据库中。 停止 Confluence。 复制 Confluence Home 目录。这个能够保证你在备份恢复的时候可能出现错误的重写和数据丢失，能够让你在出现问题的时候重新恢复数据。 如果你使用的是一个外部数据库，请确保你外部数据库也创建了一个备份。你可以使用外部数据库提供的各种工具来创建这个备份。 步骤 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 的其他站点。 https://www.cwiki.us/display/CONFLUENCEWIKI/Migrating+to+Another+Database

数据库整合的限制 注意： Confluence 自带的 XML 方式导出方法并不适用于备份和整合大数据集。这里有一些第三方的数据库工具你可以使用能够帮助你对大数据集进行备份和整合。如果你在选择正确工具的方面需要帮助，或者你需要对整合整个过程需要帮助，你可以联系 Atlassian Experts 来获得相关的指导。 数据库整合 有下面 2 种方法可以帮助你对对数据进行整合，这两种方法在下面的内容中进行描述说明： 方法 1  是最标准的方法和处理流程。 如果你整个安装实例的附件超过了 500MB，请使用 方法 2。 https://www.cwiki.us/display/CONFLUENCEWIKI/Migrating+to+Another+Database