Atlassian 推荐创建一个可选的数据库备份方案： 使用你数据库提供的备份和恢复工具 为了避免数据不完整和备份中断，我们推荐你在备份和恢复 Confluence 数据库的时候关闭 Confluence 实例。 为你的 Confluence 目录创建一个系统文件备份 为你共享的 home 目录创建一个系统文件备份（仅针对集群方式部署） 一旦上面的备份策略被实施了，你可以禁用 Confluence 自带的每日备份。每日备份通常在 Confluence 的 Scheduled Jobs 中进行配置，你可以通过 '管理员控制台（Administration Console） > 管理（Administration ）> 计划任务（Scheduled Jobs）'。 我们强烈推荐你使用上面 2 步骤的备份方案，相对使用 XML 的备份方案来说，上面 2 步的备份方法相对 Confluence 的备份来说更加有效和可靠。你可以通过上面的备份数据完全恢复你的 Confluence 整个站点，包括所有的数据，附件和相关的配置信息。请参考 Restoring Data from other Backups 页面中的内容对数据进行回复。 https://www.cwiki.us/display/CONFLUENCEWIKI/Production+Backup+Strategy
如果你是下面的情况，Confluence 的自动每日 XML 备份可能适合你： 正在评估使用 Confluence 你对数据库的管理并不是非常熟悉同时你的 Confluence 安装实例的数据量并不大 一旦你的 Confluence 安装实例中超过了上千的页面，相对数据库自带的数据备份来说，XML 的备份方案就显得没有那么有效了。XML 的备份方法需要占用服务器的大量内存来运行，同时在恢复的时候也比较容易失败。 https://www.cwiki.us/display/CONFLUENCEWIKI/Production+Backup+Strategy
Confluence 的 Attachment Storage Configuration 可以配置 Confluence 将附件存储在 home directory，或者是存储在数据库中。 Database 备份 使用你的数据库管理工具来创建一个你的 Confluence 数据库备份。如果你的数据库同时还存储了你的附件，在随后的数据库导入中将会导入所有的内容。针对有大量附件的安装实例，请注意当前的 Confluence 整合附件将会在一个单独的事物中：CONF-9888。 Attachment 备份 如果你的附件存储在文件系统中，附件将会放置在你 Confluence 安装 home 目录下的 attachments 中，拷贝这个文件夹中的所有内容，就可以备份所有的附件了。 希望从这些备份中恢复，请参考 Restoring Data from other Backups 页面中的内容。 https://www.cwiki.us/display/CONFLUENCEWIKI/Site+Backup+and+Restore
XML 站点备份的方式只针对 Confluence 包含有几千页面的情况，XML 备份所需要的时间随着数据量的变化而增加。另外的一个问题是 XML 站点的备份将会包含上 G 的附件数据，随着数据量的增加，磁盘使用量也会显著增加。这是因为每一个 XML 备份都能够用来完全恢复站点。例如，一个 1GB 数据量的 Confluence 安装实例，如果采取每天备份的方式，一个月后，这个实例将会占用 30 GB 的存储空间。当你在管理大数据量的 Confluence 安装实例的时候，你可以在备份策略中不备份附件，然后你可以手动备份你的 Confluence 附件， 这个附件通常存储在 home directory 目录中或者数据库。备份管理可以备份至修改的文件来替换备份所有内容，通过这种方式能节省大量的存储空间。 可以接受 可以接受 XML 站点备份同时备份附件 可以接受 不可以接受 XML 站点备份和最小的附件，加上手动备份所有附件 不可以接受 不可以接受 手动备份附件和数据库 创建延迟（Creation Delay）是创建 XML 站点备份和最小附件所需要的时间。 磁盘使用（Disk Usage）可以通过当前数据量的大小和备份的频率同时进行评估。 https://www.cwiki.us/display/CONFLUENCEWIKI/Site+Backup+and+Restore
Atlassian 推荐针对生产环境中安装使用的 Confluence 使用原始数据库工具备份策略。 在默认的情况下，Confluence 每天都会备份所有数据和附件到 XML 文件备份中。这些文件被称为 XML 站点备份，同时这些文件存储在 Confluence home 目录中的 backups 目录下面。可选的，你也可以手动创建一个 XML 站点的备份。这种备份方式针对中小数据量的 Confluence 可以进行使用。这种备份方式针对有很多页面和附件的时候就变得不适用了（请查看下面）。 Restore your site from an XML site backup Manually create an XML site backup Configuring Backups User Submitted Backup & Restore Scripts XML 站点文件备份的方式针对只有几千页面的中小数据量还是非常有效的。但是针对有大量页面的 Confluence 安装实例，这种备份方式就会变得非常缓慢，并且还会大量占用磁盘存储空间。 注意：插件是不会备份到 XML 的备份中的。当你从 XML 的备份中重新导入到新的 Confluence 站点中的话，你需要为你的站点重新安装所有 Confluence 没有捆绑在一起的插件（插件使用的数据表也不会备份到 XML 文件中）。 https://www.cwiki.us/display/CONFLUENCEWIKI/Site+Backup+and+Restore
如果你对 Confluence 进行升级（手动或者使用安装器），你需要： 停止 Confluence （如果你已经尝试开始启动）。 拷贝你的数据库驱动到 <installation-directory>/lib 目录。 编辑 <installation-directory>/conf/server.xml 同时添加你的数据源资源。 编辑 <installation-directory>/confluence/WEB-INF/web.xml 到配置 Confluence 使用数据源。 如果你忘记进行这些步骤，Confluence 将会在你升级完成后停止启动，并且你将会看到下面的错误信息： HTTP Status 500 - Confluence is vacant, a call to tenanted [public abstract org.hibernate.Session org.hibernate.SessionFactory.getCurrentSession() throws org.hibernate.HibernateException] is not allowed. https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+a+datasource+connection
如果你希望在使用 JDBC 直接方式的应用中切换到使用数据源： 停止 Confluence. 备份下面的文件，以防止你可能需要重新恢复你的配置： <installation-directory>/conf/server.xml <installation-directory>/confluence/WEB-INF/web.xml <home-directory>/confluence.cfg.xml 请按照上面新安装使用的步骤，同时拷贝你的驱动并且将数据源添加到正确的文件中。你可以针对当前数据连接中的配置找到细节信息 <home-directory>/confluence.cfg.xml。 编辑 <home-directory>/confluence.cfg.xml 文件，同时删掉 hibernate 元素之前的所有内容。 将下面的内容插入到 <properties> 部分。 PostgreSQL... <property name="hibernate.setup"><![CDATA[true]]></property> <property name="hibernate.dialect"><![CDATA[net.sf.hibernate.dialect.PostgreSQLDialect]]></property> <property name="hibernate.connection.datasource"><![CDATA[java:comp/env/jdbc/confluence]]></property> Microsoft SQL Server... <property name="hibernate.setup"><![CDATA[true]]></property> <property name="hibernate.dialect"><![CDATA[net.sf.hibernate.dialect.SQLServerIntlDialect]]></property> <property name="hibernate.connection.datasource"><![CDATA[java:comp/env/jdbc/confluence]]></property> MySQL... <property name="hibernate.setup"><![CDATA[true]]></property> <property name="hibernate.dialect"><![CDATA[com.atlassian.hibernate.dialect.MySQLDialect]]></property> <property name="hibernate.connection.datasource"><![CDATA[java:comp/env/jdbc/confluence]]></property> Oracle... <property name="hibernate.setup"><![CDATA[true]]></property> <property name="hibernate.dialect"><![CDATA[com.atlassian.confluence.impl.hibernate.dialect.OracleDialect]]></property> <property name="hibernate.connection.datasource"><![CDATA[java:comp/env/jdbc/confluence]]></property> 重启 Confluence. https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+a+datasource+connection
如果在你的 Tomcat 中配置了数据源，并且Confluence 设置指南在安装的时候检测到这个配置的时候，配置数据源的选项将会提供给你进行配置。入股你希望使用数据源，请参考下面的配置。 1. 停止 Confluence 在 Confluence 的配置指南中，你将会提示选择你的数据库，在这个时候，你应该： 使用 bin/stop-confluence.sh or bin/stop-confuence.bat 停止 Confluence。 备份下面的文件，以防止你可能需要重新恢复你的配置： <installation-directory>/conf/server.xml <installation-directory>/confluence/WEB-INF/web.xml <home-directory>/confluence.cfg.xml 2. 添加你的数据库驱动 拷贝你的数据库驱动到 <installation-directory>/lib 目录中。 下面的连接是有关如果找到你的数据库驱动： PostgreSQL：捆绑到了 Confluence 中， 在<installation-directory>/confluence/WEB-INF/lib/postgresql-x.x.x.jar Microsoft SQL Server：捆绑到了 Confluence 中， 在 <installation-directory>/confluence/WEB-INF/lib/mssql-jdbc-x.x.x.x.jar MySQL：进入 Database JDBC Drivers 页面来下载驱动 Oracle：进入 Database JDBC Drivers 页面来下载驱动 3. 在 Tomcat 中配置数据源 下一步，将数据源配置到 Tomcat 中。 编辑 <installation-directory>/conf/server.xml 找到下面的行： <Context path="" docBase="../confluence" debug="0" reloadable="true"> <!-- Logger is deprecated in Tomcat 5.5. Logging configuration for Confluence is specified in confluence/WEB-INF/classes/log4j.properties --> 插入下面的数据源资源 Resource 元素。针对你具体使用的数据库不同，需要做一些修改（插入 Context 元素，在 <Context.../> 行，同时在 Manager 之前）。 PostgreSQL... <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource" username="<database-user>" password="<password>" driverClassName="org.postgresql.Driver" url="jdbc:postgresql://<host>:5432/<database-name>" maxTotal="60" maxIdle="20" validationQuery="select 1"/> Microsoft SQL Server... <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource" username="<database-user>" password="<password>" driverClassName="com.microsoft.sqlserver.jdbc.SQLServerDriver" url="jdbc:sqlserver://<host>:1433;database=<database-name>" maxTotal="60" maxIdle="20" validationQuery="select 1"/> 如果你正在使用的 Confluence 6.3 及其早期的版本，针对 SQL Server 数据库服务器，你 制定jTDS 驱动。请参考 Configuring a SQL Server Datasource in Apache Tomcat 中的文档来进行配置。 MySQL... <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource" username="<database-user>" password="<password>" driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://<host>:3306/<database-name>?useUnicode=true&characterEncoding=utf8" maxTotal="60" maxIdle="20" defaultTransactionIsolation="READ_COMMITTED" validationQuery="Select 1"/> Oracle... <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@<host>:1521:<SID>" username="<database-user>" password="<password>" connectionProperties="SetBigStringTryClob=true" accessToUnderlyingConnectionAllowed="true" maxTotal="60" maxIdle="20" maxWaitMillis="10000"/> See how to find your Oracle URL. 替换 <database-user>, <password>, <host> 或 <database-name> （或针对 Oracle 使用 <SID> ）来配置你自己的数据库。你同事还需要修改这个端口，如果你的数据库没有在默认端口中运行的话。 配置连接池和其他属性，请参考 Apache Tomcat 8 Datasource documentation 页面来获得更多的信息。 配置属性... 如果你计划使用协作编辑，你需要确定： 你需要使用支持的数据库驱动。如果你使用了不支持的数据库驱动或者自定义的 JDBC 驱动，或者你数据源中的 driverClassName，协作写编辑将会失败。请参考 Database JDBC Drivers 页面中的内容。 你数据库连接池需要允许有足够的连接数来同时支持 Confluence 和 Synchrony （默认的最大连接池数量为 15）。 在你的数据库中，你使用简单用户名和密码授权。 4. 配置 Confluence web 应用 配置 Confluence 来使用这个数据源： 编辑 <CONFLUENCE_INSTALLATION>/confluence/WEB-INF/web.xml. 在 </web-app> 元素之前插入下面的内容： <resource-ref> <description>Connection Pool</description> <res-ref-name>jdbc/confluence</res-ref-name> <res-type>javax.sql.DataSource</res-type> <res-auth>Container</res-auth> </resource-ref> 5. 重启 Confluence 然后继续设置进程 现在你的数据源已经成功配置了，你可以继续你 Confluence 的安装进程了。 使用 bin/start-confluence.sh 或 bin/start-confuence.bat 来重启你的 Confluence Go to http://localhost:8090 to return to the setup wizard. 当提示选择 My own database (datasource)。 输入你数据源的 JNDI 名称，例如，java:comp/env/jdbc/confluence 针对弹出的内容来完成你 Confluence 的设置。 https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+a+datasource+connection
这个指南指导你如何配置使用 JNDI 数据源来连接到你的数据库。使用这个类型的连接，Confluence 将会询问应用服务器（Tomcat）中你配置的连接信息。 如果你希望使用 JDBC 的数据库连接方式，请参考下面的指南： Database Setup for PostgreSQL Database Setup for SQL Server Database Setup For MySQL Database Setup for Oracle JDBC 直接连接 Confluence 到数据库为更加常用的连接方式，而且使用这种方式连接到数据库更加简单，在升级 Confluence 的时候也不需要重新配置 Confluence。 https://www.cwiki.us/display/CONFLUENCEWIKI/Configuring+a+datasource+connection
确定 Confluence 在数据库连接池中校验数据库连接： 停止 Confluence。 编辑 <installation-directory>/conf/server.xml 文件（或者基于在那里你配置你的数据源）。 针对你的额数据源找到 Resource 元素，然后添加 "validationQuery" 参数，下面的配置是针对 PostgreSQL 数据库的，其他的数据库的配置也类似。请记住针对你数据库类型配置正确的值。 server.xml (excerpt) ... <Resource name="jdbc/confluence" auth="Container" type="javax.sql.DataSource" username="postgres" password="postgres" driverClassName="org.postgresql.Driver" url="jdbc:postgresql://localhost:5432/yourDatabaseName" maxTotal="60" maxIdle="20" validationQuery="select 1" /> ... 保存 conf/server.xml 重启 Confluence. 你应该可以从中断的数据库连接中重新获得所有的数据库连接而不需要重启 Confluence。 https://www.cwiki.us/display/CONFLUENCEWIKI/Surviving+Database+Connection+Closures