外部データベース接続のトラブルシューティング

Confluence の設定時に共通して発生する管理課題は、データベース接続の問題を特定することです。このページでは、データベース接続の問題を特定するのに役立つヘルパー ユーティリティについて、JSP ページの形で説明します。このユーティリティは使用するアプリケーション サーバーでデータベースに接続できるかどうかをチェックします。使用するアプリケーション サーバーがデータベースに接続できない場合、Confluence もデータベースに接続できません。

アトラシアン データベース チェック ユーティリティの概要

このユーティリティを使用すると、次のことができます。

• アプリケーション サーバーが JDBC による直接接続またはアプリケーション サーバー内のデータソースのいずれかを使用して、データベースを正常に照会できることを確認します。
• 上記の失敗が生じる場合に、発生の可能性がある設定の問題を特定します。

このユーティリティが実行する内容：

• JDBC ドライバをメモリにロードできることを確認し、すでにロードされている内容を表示します。
• JDBC URL に接続し、 データベースから「select 1」を実行します。
• JNDI 環境でのデータソースを検索し、上記の操作を行います。
• （JDBC JAR ファイルがあることを確認するために）システム クラスパスを表示します。

ユーティリティの使用

すでに Confluence 設定が完了している場合

1. Download the attached testdatabase.jsp to your <confluence-install>\confluence directory.
2. Confluence を再起動します。
3. http://MY-CONF-SERVER:MY-CONF-PORT/testdatabase.jsp に移動します。
4. Check that your database driver is loaded into memory. If not, check the system classpath for the JDBC driver file, and that the driver is in the <confluence-install>\lib directory (for Confluence version 2.10 onwards) or <confluence-install>\common\lib (for earlier versions). Here are some instructions.
5. Confluence が使用するデータベース設定を入力し、データベースをテストします。エラーが表示された場合は、データベース サービスが実行されているか、場所が一致しているか、指定されたユーザーが実際に存在し、正しいログイン情報と権限を持っているか確認します。エラーについてグーグル検索すれば、回避策を見つけられる可能性があります。

「データベース設定」のエラーのために Confluence を設定できない場合

1. セットアップの「データベース設定」のステップで、JDBC 直接接続またはデータソース接続に使用している DB 設定を記録します。
2. Download the attached testdatabase.jsp to your <confluence-install>\confluence directory.
3. Rename your <confluence-install>\confluence\WEB-INF\web.xml file to backup web.xml. This disables redirection.
4. Confluence を再起動します。
5. http://MY-CONF-SERVER:MY-CONF-PORT/testdatabase.jsp に移動します。
6. Check that your database driver is loaded into memory. If not, check the system classpath for the JDBC driver file, and that the driver is in the <confluence-install>\common\lib directory as described in these instructions.
7. 記録したデータベース設定を入力し、データベースをテストします。エラーが表示された場合は、データベース サービスが実行されているか、場所が一致しているか、指定されたユーザーが実際に存在し、正しいログイン情報と権限を持っているか確認します。エラーについてグーグル検索すれば、回避策を見つけられる可能性があります。
8. After correcting the error, rename <confluence-install>\confluence\WEB-INF\backup web.xml back to web.xml.

注意

If you use this utility, please let us know ways in which we could improve it or leave helpful hints for others here.
For a comprehensive set of database instructions that might be helpful for troubleshooting, please refer to the following links:

• PostgreSQL
• MySQL

テクニカル サポートの依頼

上記の提案を試みた後も行き詰まっている場合は、使用しているデータベースのセットアップに関する情報を添えて、サポート チームへのリクエストを起票してください。