Confluence Data Center を Amazon Aurora に接続する

ここでは、Jira を既存の Amazon Aurora PostgreSQL データベースに接続する方法について説明します。

Amazon Aurora は Data Center ライセンスでのみサポートされています

Jira Data Center は、単一ライターの、PostgreSQL 互換の Amazon Aurora のクラスタ化データベースの使用をサポートしています。一般的なプロダクショングレードのクラスタでは、異なるアベイラビリティ ゾーンに少なくとも 1 つのリーダーが含まれます。ライターが失敗した場合、Amazon Aurora はリーダーの 1 つを自動的にプロモートしてライターにします。詳細は「Amazon Aurora の特徴: PostgreSQL 互換エディション」 を参照してください。

はじめる前に

  • ご利用の Amazon Aurora のバージョンがサポートされていることを確認します。「サポート対象プラットフォーム」を参照してください。
  • Shut down Jira before you begin, unless you are running the setup wizard.

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

Jira Data Center では、以下の構成での Amazon Aurora クラスタの使用をサポートしています。

  • 1 つ以上のリーダーにレプリケートするライターが 1 つのみ必要。

  • PostgreSQL エンジンはバージョン 9.6 以降である。

詳細は「サポート対象プラットフォーム」 を確認してください。

AWS ドキュメント

AWS は、Aurora データベースのセットアップおよびそこへの移行に役立つガイドを提供しています。

また、Amazon はマネージド移行を実現するための AWS Database Migration Service も提供しています。このサービスは、最小限のダウンタイムで、さまざまなソース データベースから Aurora への移行をサポートするものです。

2. Configure your Jira server to connect to your PostgreSQL database

There are two ways to configure your Jira server to connect to your Amazon Aurora database:

  • Using the Jira setup wizard — Use this method if you have just installed Jira, and you are setting it up for the first time. Your settings will be saved to the dbconfig.xml file in your Jira home directory.
  • Using the Jira configuration tool — Use this method if you have an existing Jira instance. Your settings will be saved to the dbconfig.xml file in your Jira home directory.

各設定手法の手順説明

Jira setup wizard

The Jira setup wizard will display when you access Jira for the first time in your browser.

  1. 最初の画面の [Configure Language and Database] で、[Database Connection] に [ My own database] を設定します。

  2. [Database Type] を [Aurora PostgreSQL 9.6 (DC only)] に設定します。

  3. 下記の「データベース コネクション フィールド」セクションを参照して各フィールドを入力します。

  4. 接続をテストし、保存します。

Jira configuration tool

  1. Run the Jira configuration tool as follows:


  2. [Database] タブに移動します。

  3. [Database Type] を [Aurora PostgreSQL 9.6 (DC only)] に設定します。

  4. 下記の「データベース コネクション フィールド」セクションを参照して各フィールドを入力します。

  5. 接続をテストし、保存します。
  6. Restart Jira.

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

セットアップウィザード / 設定ツールdbconfig.xml のタグ説明
ホスト名

<url> タグに配置されます (下記の例の太字部分):<url>jdbc:postgresql://dbserver:5432/jiradb?targetServerType=master</url>

PostgreSQL サーバーがインストールされている PC 名または IP アドレス。
ポート<url> タグに配置されます (下記の例の太字部分):
<url>jdbc:postgresql://dbserver:5432/jiradb?targetServerType=master</url>
PostgreSQL サーバがリッスンしている TCP/IP ポート。このフィールドが空の場合、デフォルト ポートが使用されます。
データベース<url> タグに配置されます (下記の例の太字部分):
<url>jdbc:postgresql://dbserver:5432/jiradb?targetServerType=master</url>

The name of your PostgreSQL database (into which Jira will save its data). You should have created this in Step 1 above.

ユーザ名

<username> タグに配置されます (下記の例の太字部分):
<username>jiradbuser</username>

PostgreSQL サーバーに接続するために JIRA が使用するユーザー。上記 ステップ 1 で作成済みのはずです。
パスワード<password> タグに配置されます (下記の例の太字部分):
<password>jiradbuser</password>
PostgreSQL サーバーとの認証に利用するユーザーのパスワード。
スキーマ<schema-name> タグに配置されます (下記例の太字部分):
<schema-name> public </schema-name>

PostgreSQL データベースが使用するスキーマ名。

スキーマの要件

PostgreSQL 7.2 以降の場合は、<schema-name/> 要素で指定するスキーマが必要です。お使いの PostgreSQL データベースがデフォルトの public スキーマを使用している場合、それを以下のように <schema-name/> 要素内で指定する必要があります。お使いのデータベース スキーマ名が小文字であることを確認します。Jira では、スキーマ名に大文字が含まれる Postgfe SQL データベースは使用できません。


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

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

<?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?targetServerType=master</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. Start Jira

これで、Amazon Aurora データベースに接続するための Jira Data Center の構成が完了しました。次のステップでは、これを起動させます。

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

最終更新日 2023 年 5 月 31 日

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

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