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

このページでは、PostgreSQL データベースを使用する場合の Confluence 設定方法を説明します。

ステップ 1. 前提条件を確認する

始める前に、以下の内容を確認します:

  • 使用予定の PostgreSQL がサポート対象であることを確認してください。サポート対象であるか否かは、サポートするプラットフォームで確認できます。使用予定の PostgreSQL がサポート対象外の場合は、Confluence のインストール前に PostgreSQL をサポート対象バージョンにアップグレードしてください。
  • Confluence を評価していて、お使いのデータを新しいデータベースに転送されたい場合は、まず次のガイドを参考にして下さい: 別のデータベースへの移行
  • 別のデータベースから移行してくる場合、まず次のガイドを参考にして下さい:別のデータベースへの移行

ステップ 2. PostgreSQL のインストール

PostgreSQL がインストールされていない場合は、ここでインストールします。

このページの内容:

関連ページ:

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

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

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

  1. Create a database user (for example confluenceuser)
    • 新しいユーザーは、データベース オブジェクトを作成できる必要があり、ログインできる権限を持っている必要があります。 
  2. Create a database (for example confluence)
    • 所有者は新しいデータベース ユーザー (例: confluenceuser) です。
    • Character encoding should be utf8 encoding.

コマンドラインの代替として、pgAdminを使用し、このステップを完了することができます。PostgreSQL のインストール時にグラフィカルインストーラーを使用した場合は pgAdmin III がコンピューターに既にインストールされています。

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

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

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

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

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

  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 データベースにデータを保存できるようになりました。

注意

  • 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.

  • 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).
最終更新日 2017 年 9 月 9 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.