Apache Tomcat で PostgreSQL データソースを設定する
このページでは、Confluence 向けに PostgreSQL データソース接続を設定する方法を説明します。
Step 1. Shut down Tomcat
- Run
bin/shutdown.sh
orbin/shutdown.bat
to bring Tomcat down while you are making these changes. - Make a backup of your
<CONFLUENCE_HOME>/confluence.cfg.xml
file and your<CONFLUENCE_INSTALLATION>/conf/server.xml
file, so that you can easily revert if you have a problem.
ステップ 2. PostgreSQL サーバーのデータベースドライバをインストールする
- PostgreSQL サーバー JDBC ドライバ JAR ファイルをダウンロードします。
- Links are available on this page: Database JDBC Drivers.
- Alternatively, you can get the driver from your Confluence installation:
/confluence/WEB-INF/lib/postgresql-x.x-x.jdbcx.jar
, where 'x' represents a version number.
- Copy the JAR file into the
lib
folder of your Tomcat installation:<TOMCAT-INSTALLATION>/lib
.
Step 3. Configure Tomcat
- Edit the
conf/server.xml
file in your Tomcat installation. 以下の行を見つけます。
<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 -->
Insert the DataSource
Resource
element inside theContext
element, directly after the opening<Context.../>
line, beforeManager
:<!-- If you're using Confluence 5.7 or below; change maxTotal to maxActive --> <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="25" maxIdle="10" validationQuery="select 1" />
- Replace the
username
andpassword
parameters with the correct values for your database - In the
url
parameter, replace the word 'yourDatabaseName
' with the name of the database your Confluence data will be stored in.
- Replace the
メモ:
- If switching from a direct JDBC connection to datasource, you can find the above details in your
<CONFLUENCE_HOME>/confluence.cfg.xml
file. 以下は、Tomcat の標準のデータソース リソース ファクトリ (
org.apache.tomcat.dbcp.dbcp.BasicDataSourceFactory
) の設定プロパティです。- driverClassName — 使用される JDBC ドライバの完全修飾 Java クラス名。
- maxTotal — 同時にプールに存在可能なデータベース接続の最大数。
- maxIdle — このプールで同時にアイドル状態可能な接続最大数。
- maxWaitMillis — 利用可能な接続が存在しない場合、例外をスローする前に接続が戻されるのをプールが待機する最大時間 (ミリ秒)。
- password — JDBC ドライバに渡されるデータベースのパスワード。
- url — JDBC ドライバに渡される接続 URL。(後方互換性のために、プロパティの driverName も認識されます。)
- user — JDBC ドライバに渡されるデータベースユーザー名
- validationQuery — 接続がアプリケーションに戻される前に接続を検証するためにプールによって使用される SQL クエリ。指定する場合、クエリは少なくとも1つの行を返す SQL SELECT 文でなければなりません。
- Why is the
validationQuery
element needed? When a database server reboots, or there is a network failure, all the connections in the connection pool are broken and this normally requires a Application Server reboot. However, the Commons DBCP (Database Connection Pool) which is used by the Tomcat application server can validate connections before issuing them by running a simple SQL query, and if a broken connection is detected, a new one is created to replace it. To do this, you will need to set the "validationQuery" option on the database connection pool.
ステップ 4. Confluence Web アプリケーションを設定する
- Edit this file in your Confluence installation:
<CONFLUENCE_INSTALLATION>/
confluence/WEB-INF/web.xml Insert the following element just before
</web-app>
near the end of the file:<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>
既存の Confluence インストールを Tomcat データソースを使用するように変更する場合:
ファイルを編集します。<CONFLUENCE_HOME>/
confluence.cfg.xml- Delete any line that contains a property that begins with
hibernate.
Insert the following at the start of the
<properties>
section:<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>
Step 5. Restart Tomcat
Run bin/startup.sh
or bin/startup.bat
to start Tomcat with the new settings.
最終更新日: 2015 年 12 月 2 日
Powered by Confluence and Scroll Viewport.