PostgreSQL データベースセットアップ

1. Download and install PostgreSQL. Please note the following information when installing PostgreSQL:
   • インストール中に入力を求められるパスワードは、データベースのルートレベルアカウントである 'postgres' アカウントのパスワードです。このアカウントは、スーパーユーザー ('postgres') とも呼ばれます。このユーザー名とパスワードはデータベースにログインするたびに必要ですので、忘れないようにしてください。
   • PostgreSQL のデフォルトポート番号は 5432 です。デフォルトポート番号を変更する場合、変更後の番号ポートを使用しているサービスがあるときはそれとの競合がないことを確認してください。また、これ以降の説明におけるデータベースポート番号記載箇所はすべて読み替えてください。
   • 所在地に対応するロケールを選択します。ロケールを選択します。
   • インストール終了後にスタックビルダを起動しないでください。

ステップ 3. PostgreSQL データベースとユーザー情報のセットアップ

次は、Confluence のデータを保存するための PostgreSQL データベースを作成し、データベースへのアクセス権限を有するユーザー情報を設定する必要があります。 

1. Create a database user (for example confluenceuser)
   • Your new user must be able to create database objects and create roles. 
2. Create a database (for example confluence)
   • 所有者は新しいデータベース ユーザー (例: confluenceuser) です。
   • Character encoding should be utf8 encoding.

You can use pgAdmin as an alternative to the command line to complete this step.  If you used the graphical installer when installing PostgreSQL, pgAdmin will be already installed on your computer.

ステップ 4. Confluence および PostgreSQL データベースドライバーのインストール

PostgreSQL への接続方法としてJDBC 直接接続またはデータソース接続のどちらを使用するかを、利用環境に合わせて決めておいてください。分からないときは JDBC 直接接続を使用してください。

Confluence のインストールを行っていない場合は、ここでインストールしてください。Confluence インストールガイドをご覧ください。

• Postgre SQL への JDBC 直接接続を使用する場合は、Confluence のインストールを行った後、下記の説明に従って直ちに Confluence セットアップウィザードに進んでください。 PostgreSQL JDBC ドライバーは Confluence に組み込まれています。参考ページ: データベース JDBC ドライバ。
• PostgreSQL へのデータソース接続を使用する場合は:
  • Confluence インストール後、Confluence セットアップウィザードに進まずに一旦作業を停止してください。Confluence セットアップウィザードを一部開始してしまった場合は、データベースセットアップの前で一旦作業を停止してください。セットアップウィザードは後で停止したステップから再開することができます。
  • PostgreSQL データソース Apache Tomcat 構成の説明に従って設定してください。

Step 5. Confluence セットアップウィザードにおけるデータベース接続のセットアップ

Start Confluence, go to the Confluence Setup Wizard in your browser, and follow these steps:

1. 評価用インストールもしくは本番環境用インストールの選択を求められたときは、本番環境を選択します。
2. 組み込みデータベースを使用するか、外部データベースに接続するかを選択するステップで、ドロップダウンリストから PostgreSQLを選択してから外部データベースボタンをクリックします。
3. 利用環境に合わせてあらかじめ決めておいた方針に従って、JDBC 直接接続またはサーバー管理データソース接続のどちらかを選択します。
   • JDBC 接続の場合:

• • • Driver Class Name を求められた場合、次のように入力します。

      org.postgresql.Driver

• • • Database URL を入力するステップでは、次のように指定します:

      jdbc:postgresql://<server>:<port>/<database>
      

      For example:  jdbc:postgresql://localhost:5432/confluence

      Note: If you need to connect to an SSL database, add the ssl=true parameter in the database URL. For example: jdbc:postgresql://localhost:5432/confluence?ssl=true

    • Enter the username (for example confluenceuser) and password you chose earlier when setting up your Confluence database.
  • For a datasource connection: Set the Datasource Name to the following: java:comp/env/jdbc/confluence


以上で Confluence が PostgreSQL データベースにデータを保存できるようになりました。

スクリーンショット: Confluence セットアップウィザードにおける PostgreSQL への JDBC 接続設定画面

注意

• If the server that is hosting the PostgreSQL database is not the same server as Confluence, then please ensure that the Confluence server can contact the database server. Please also refer to the PostgreSQL documentation on how to set up pg_hba.conf. If the pg_hba.conf file is not set properly, remote communication to the PostgresSQL server will fail.
• SQL クエリの実行: PGAdmin III は、サーバーの日常保守作業において SQL ブラウザーとして利用することも可能です

トラブルシューティング

• 次のエラー メッセージが表示された場合は、localhost から接続する際に必要となる全てのデータベース権限を confluenceuser ユーザーに付与したかどうかを確認します。

  Could not successfully test your database: : Server connection failure during transaction. Due to underlying exception: 'java.sql.SQLException: Access denied for user 'confluenceuser'@'localhost' (using password: YES)'

• Confluence がクラスファイルを欠いていると訴えた場合は、JDBC ドライバーを誤ったフォルダに配置した可能性があります。

• If you are unable to connect to the database from Confluence and they are on different machines, most likely you have a firewall in between the two machines or your pg_hba.conf file is misconfigured. Verify that your firewall is set to allow connections through 5432 or double check your hba configuration.

• Confluence と共に使用する PostgreSQL データベースセットアップ時の既知の問題点に関しては、PostgreSQL の既知の問題点をご覧ください。
• If none of the above describes your issue, please create a support ticket at http://support.atlassian.com and be sure to include your logs (found in <CONFLUENCE-INSTALLATION>/logs and <CONFLUENCE-HOME>/logs).