PostgreSQL データベースセットアップ
1. PostgreSQL のインストール
PostgreSQL がまだインストールされていない場合、ダウンロードしてインストールします。
PostgreSQL をインストールする際のヒントをいくつか紹介します。
- インストール中に入力を求められるパスワードは、データベースのルートレベル アカウント (スーパー ユーザー) である 'postgres' アカウントのパスワードです。このユーザー名とパスワードはデータベースにログインするたびに必要になるため、忘れないようにしてください。
- PostgreSQL の既定のポート番号は 5432 です。既定ポートを変更する場合、そのポートを使用しているサービスとの競合がないことを確認してください。
- 最適なロケールを選択します。
- インストーラーの完了後にスタック ビルダーを起動しないでください。
2. データベースおよびユーザーを作成します。
PostgreSQL をインストールしたら、次の手順を実行します。
- データベース ユーザー (例:
confluenceuser) を作成します。- 新しいユーザーは、データベース オブジェクトを作成できる必要があり、ログインできる権限を持っている必要があります。
- 次に、データベース (例:
confluence) を作成します。- 所有者は新しいデータベース ユーザー (例:
confluenceuser) です。 - 文字エンコーディングは、
utf8エンコーディングに設定する必要があります。 - 照合順序を
utf8に設定する必要もあります。その他の照合順序の場合 ("C" など) 、Confluence で問題が発生することがあることが確認されています。
Windows で PostgreSQL を実行している場合は、同等の文字タイプと照合順序をロケールに使用します。例:English_United States.1252 Linux システムでロケールが utf8 ではない場合、データベース作成時に utf8 として LC_CTYPE を含めます。
- 所有者は新しいデータベース ユーザー (例:
コマンド ラインの代わりに pgAdmin を使用してこのステップを完了することができます。
3. Confluence のインストール
お使いのオペレーティング システムに Confluence をインストールするための詳細な手順については、Confluence インストール ガイドを確認してください。
4. データベースの詳細を入力する
Confluence セットアップ ウィザードを利用して、お使いのデータベースに Confluence を接続できます。必ず「独自データベース」を選択してください。
JDBC 接続を使用する (既定)
データベースへの接続には JDBC の使用を推奨します。
Confluence セットアップ ウィザードは 2 つのセットアップ オプションを提供します。
- シンプル - 最も簡単にデータベースに接続する方法です。
- 接続文字列を使用 - 追加パラメーターを指定する必要があり、データベース URL の作成に慣れている場合は、このオプションを使用します。
セットアップ タイプに応じて、次の情報を求めるプロンプトが表示されます。
| セットアップ タイプ | フィールド | 説明 |
|---|---|---|
| simple | ホスト名 | データベース サーバーのホスト名または IP アドレス。 |
| simple | ポート | PostgreSQL ポートです (Postgres をインストールした際にポートを変更していなければ、既定の 5432 になります)。 |
| simple | データベース名 | Confluence データベースの名前 (上記の例では confluence)。 |
| 接続文字列を使用 | データベース URL | データベース URL は次の形式で入力されます。jdbc:postgresql://<server>:<port>/<database> 例: SSL データベースに接続する必要がある場合は、データベース URL に |
| 両方 | ユーザ名 | 専用データベース ユーザーのユーザー名 (上記の例では confluenceuser)。 |
| 両方 | パスワード | 専用データベース ユーザーのパスワードです。 |
JNDI データソースを使用する
JNDI データソースを使用したい場合、Confluence をセットアップする前に必要な手順を「データソース接続の設定」で確認してください。セットアップ ウィザードは Tomcat 構成内のデータソースを検出した場合にのみ、データソースを使用するオプションのみを提供します。
5. データベース接続のテスト
データベースのセットアップ画面で [テスト接続] ボタンをクリックすると、次の点をチェックできます。
- Confluence データベースがご利用のデータベース サーバーに接続できること
- データベースの文字エンコーディングが正しいこと
- データベース ユーザーがデータベースに対する適切な権限を持っていること
テストが成功したら、[次へ] をクリックして Confluence のセットアップ プロセスを続行します。
Confluence と PostgreSQL が異なるサーバー上でホストされている場合、「PostgreSQL における pg_hba.conf 設定方法の説明」を参照し、Confluence と PostgreSQL がリモートで通信できることを確認してください。
トラブルシューティング
- Confluence がクラスファイルを欠いていると訴えた場合は、JDBC ドライバーを誤ったフォルダに配置した可能性があります。
- Confluence からデータベースに接続できず、それらが異なるサーバー上にある場合は、2 台のサーバー間のファイアウォールまたは
pg_hba.confファイルの設定に問題がある可能性が考えられます。ファイアウォールが 5432 番ポート経由の接続を許可する設定となっていることを確認するか、hba ファイルの設定が意図したとおりであることを念のため確認します。 Confluence と共に使用する PostgreSQL データベースセットアップ時の既知の問題点に関しては、PostgreSQL の既知の問題点をご覧ください。