Jira アプリケーションの PostgreSQL への接続

ここでは、Jira を PostgreSQL データベースに接続する方法を解説します。

はじめる前に

• ご使用の PostgreSQL のバージョンがサポート対象であることを確認します。サポート対象プラットフォームを参照してください。
• Jira を他のサーバーに移行する場合は、データのエクスポートを XML バックアップ形式で作成します。その後、「データベースの切り替え」で説明されているように、元のデータベースから新しいデータベースにデータを移行できます。
• セットアップ ウィザードを実行中の場合を除き、開始する前に Jira をシャットダウンします。

1. PostgreSQL データベースを作成・設定する

リモート TCP 接続を承認する (リモート PostgreSQL サーバーのみ)

Jira をリモート PostgreSQL サーバーに接続する場合 (PostgreSQL サーバーが Jira Server のホスト システムでローカルにインストールされていない場合)、Jira Server の IP アドレスからのリモート TCP 接続を承認するよう、data/postgresql.conf および data/pg_hba.conf ファイルを構成する必要があります。

次の PostgreSQL ドキュメントには、postgresql.conf ファイルや pg_hba.conf ファイルで利用できる listen_addresses の値についての情報が含まれています。

• PostgreSQL 9.6 ドキュメント — 接続と認証
• PostgreSQL 9.5 ドキュメント — 接続と認証
• PostgreSQL 9.4 ドキュメント — 接続と認証

data/postgresql.conf および data/pg_hba.conf ファイルを変更した後、PostgreSQL を再起動して変更を反映します。

お使いのバージョンの PostgreSQL 用にデータベースやデータベースを作成する

PostgreSQL のバージョンのユーザーやデータベースの作成に関する情報は、PostgreSQL の Web サイトに記載されています。

1. Jira が接続するためのデータベース ユーザー (ログイン ロール) を作成します (例: jiradbuser)。
   このデータベース ユーザー名を覚えておきます。これは以降のステップにおいて Jira の接続を設定する際に使用します。

2. Unicode 照合を含む課題を保存するために、Jira 用データベースを作成します (例: jiradb)。
   このデータベース名を覚えておきます。これは以降のステップにおいて Jira の接続を設定する際に使用します。

   CREATE DATABASE jiradb WITH ENCODING 'UNICODE' LC_COLLATE 'C' LC_CTYPE 'C' TEMPLATE template0;

   またはコマンドラインから

   $ createdb -E UNICODE -l C -T template0 jiradb

3. ユーザーがデータベースに接続し、データベース中でテーブルを作成・追加できる権限を持っていることを確認します。

   
   

   GRANT ALL PRIVILEGES ON DATABASE <Database Name> TO <Role Name>

4. 権限が正常に付与されたことを検証するには、データベースに接続して「\z」コマンドを実行します。

2. PostgreSQL データベースに接続するように Jira Server を設定する

Jira Server を PostgreSQL データベースに接続するには、2 つの方法があります。

• Jira セットアップ ウィザードを使用する — Jira をインストールした直後で、初めて Jira をセットアップする場合はこの方法を使用します。設定は Jira ホーム ディレクトリの dbconfig.xml ファイルに保存されます。
• Jira 設定ツールを使用する — 既存の Jira インスタンスがある場合はこの方法を使用します。設定は Jira ホーム ディレクトリの dbconfig.xml ファイルに保存されます。

各設定手法の手順説明

データベース接続フィールド

dbconfig.xml ファイルのサンプル

上記の dbconfig.xml ファイルに含まれる、pool で始まる <jdbc-datasource/> の子要素の詳細については、「データベース接続のチューニング」を参照してください。

<?xml version="1.0" encoding="UTF-8"?>

<jira-database-config>
  <name>defaultDS</name>
  <delegator-name>default</delegator-name>
  <database-type>postgres72</database-type>
  <schema-name>public</schema-name>
  <jdbc-datasource>
    <url>jdbc:postgresql://dbserver:5432/jiradb</url>
    <driver-class>org.postgresql.Driver</driver-class>
    <username>jiradbuser</username>
    <password>password</password>
    <pool-min-size>20</pool-min-size>
    <pool-max-size>20</pool-max-size>
    <pool-max-wait>30000</pool-max-wait>
    <pool-max-idle>20</pool-max-idle>
    <pool-remove-abandoned>true</pool-remove-abandoned>
    <pool-remove-abandoned-timeout>300</pool-remove-abandoned-timeout>
 
    <validation-query>select version();</validation-query>
    <min-evictable-idle-time-millis>60000</min-evictable-idle-time-millis>
    <time-between-eviction-runs-millis>300000</time-between-eviction-runs-millis>
  
    <pool-test-on-borrow>false</pool-test-on-borrow>
	<pool-test-while-idle>true</pool-test-while-idle>

  </jdbc-datasource>
</jira-database-config>

3. Jira を起動する

これで、PostgreSQL データベースに接続するための Jira の設定が完了しました。次のステップでは、Jira を起動します。

これで、Jira を PostgreSQL データベースに接続することができました。