如果你对 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
确定 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