PostgreSQL データベースセットアップ
- PostgreSQLをダウンロードおよびインストールします。PostgreSQL をインストールする際は、以下の各項目に関して注意が必要です:
- インストール中に入力を求められるパスワードは、データベースのルートレベルアカウントである 'postgres' アカウントのパスワードです。このアカウントは、スーパーユーザー ('postgres') とも呼ばれます。このユーザー名とパスワードはデータベースにログインするたびに必要ですので、忘れないようにしてください。
- PostgreSQL のデフォルトポート番号は 5432 です。デフォルトポート番号を変更する場合、変更後の番号ポートを使用しているサービスがあるときはそれとの競合がないことを確認してください。また、これ以降の説明におけるデータベースポート番号記載箇所はすべて読み替えてください。
- 所在地に対応するロケールを選択します。ロケールを選択します。
- インストール終了後にスタックビルダを起動しないでください。
ステップ 3. PostgreSQL データベースとユーザー情報のセットアップ
次は、Confluence のデータを保存するための PostgreSQL データベースを作成し、データベースへのアクセス権限を有するユーザー情報を設定する必要があります。
- Create a database user (for example
confluenceuser)- 新しいユーザーは、データベース オブジェクトを作成できる必要があり、ログインできる権限を持っている必要があります。
- Create a database (for example
confluence)- 所有者は新しいデータベース ユーザー (例:
confluenceuser) です。 - Character encoding should be
utf8encoding.
- 所有者は新しいデータベース ユーザー (例:
コマンドラインの代替として、pgAdminを使用し、このステップを完了することができます。PostgreSQL のインストール時にグラフィカルインストーラーを使用した場合は pgAdmin III がコンピューターに既にインストールされています。
ステップ 4. Confluence および PostgreSQL データベースドライバーのインストール
PostgreSQL への接続方法としてJDBC 直接接続またはデータソース接続のどちらを使用するかを、利用環境に合わせて決めておいてください。分からないときは JDBC 直接接続を使用してください。
Confluence のインストールを行っていない場合は、ここでインストールしてください。Confluence インストールガイドをご覧ください。
- Postgre SQL への JDBC 直接接続を使用する場合は、Confluence のインストールを行った後、下記の説明に従って直ちに Confluence セットアップウィザードに進んでください。PostgreSQLJDBC ドライバーは Confluence に組み込まれています。 参考ページ：データベース JDBC ドライバ。
- PostgreSQL へのデータソース接続を使用する場合は:
- Confluence インストール後、Confluence セットアップウィザードに進まずに一旦作業を停止してください。Confluence セットアップウィザードを一部開始してしまった場合は、データベースセットアップの前で一旦作業を停止してください。セットアップウィザードは後で停止したステップから再開することができます。
- Follow the steps described in 2022-11-29_04-39-46_Configuring a PostgreSQL Datasource in Apache Tomcat.
Step 5. Confluence セットアップウィザードにおけるデータベース接続のセットアップ
- 評価用インストールもしくは本番環境用インストールの選択を求められたときは、本番環境を選択します。
- 組み込みデータベースを使用するか、外部データベースに接続するかを選択するステップで、ドロップダウン リストから PostgreSQLを選択してから外部データベースボタンをクリックします。
- 利用環境に合わせてあらかじめ決めておいた方針に従って、JDBC 直接接続またはサーバー管理データソース接続のどちらかを選択します。
- JDBC 接続の場合:
Driver Class Name を求められた場合、次のように入力します。
org.postgresql.Driver
Database URL を入力するステップでは、次のように指定します:
jdbc:postgresql://<server>:<port>/<database>For example:
jdbc:postgresql://localhost:5432/confluenceNote: If you need to connect to an SSL database, add the
ssl=trueparameter 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.conffile 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.conffile 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>/logsand<).CONFLUENCE-HOME>/logs