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

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

はじめる前に

• ご使用の Oracle のバージョンがサポートされていることを確認します。サポート対象プラットフォームを参照してください。
• 以下の既知の問題を確認してください。
• Download the Oracle JDBC 12.2.0.1 driver from the Oracle website. You'll need to later copy it to the Jira installation directory.
• Jira を他のサーバーに移行する場合は、データのエクスポートを XML バックアップ形式で作成します。その後、「データベースの切り替え」で説明されているように、元のデータベースから新しいデータベースにデータを移行できます。
• セットアップ ウィザードを実行中の場合を除き、開始する前に Jira をシャットダウンします。

1. Oracle の設定

1. Ensure that you have a database instance available for Jira (either create a new one or use an existing one).

2. Within that database instance, create a user which Jira will connect as (e.g. jiradbuser).
   Remember this database user name, as it will be used to configure Jira's connection to this database in subsequent steps.

   create user <user> identified by <user_pass> default tablespace <tablespace_name> quota unlimited on <tablespace_name>;
   

   注意:

   • Oracle でユーザーを作成すると、Oracle は自動的に「スキーマ」を作成します。

   • ユーザーの作成時に、表オブジェクト用の表領域を指定する必要があります。

3. ユーザーが次の権限を持つことを確認します。

   grant connect to <user>;
   grant create table to <user>;
   grant create sequence to <user>;
   grant create trigger to <user>;

   It is very important that the user is granted the exact privileges indicated above. Jira requires only these privileges — if either less or more than these privileges are applied, some Jira functions may not work properly.

   Simply put, for Jira functions to work as expected, we advise that you grant specific privileges to the user, and not assign a role to the user.

   For example, if you grant the RESOURCE role to a user, and the RESOURCE role grants the SELECT ANY TABLE privilege, then Jira functions may not work as expected.

   したがって、上記に示した権限をそのままユーザーに付与することをお勧めします。

4. Ensure your database is configured to use the same character encoding as Jira. The recommended encoding is AL32UTF8 (the Oracle equivalent of Unicode UTF-8).

2. Oracle JDBC ドライバのダウンロード

Jira requires the Oracle JDBC 12.2.0.1 driver. Download it from the Oracle website, and copy to your installation directory.

1. Oracle JDBC ドライバをダウンロードします。
   
   
2. Copy the downloaded ojdbc8.jar file to the lib/ directory in the Jira installation directory. 

3. Oracle データベースに接続するための Jira Server の設定

Oracle データベースに接続するために JIRA サーバーを設定する方法は２つあります。

• Using the Jira setup wizard — Use this method if you have just installed Jira, and 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.

各設定手法の手順説明

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

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>oracle10g</database-type>
  <jdbc-datasource>
    <url>jdbc:oracle:thin:@dbserver:1521/ORCL</url>
    <driver-class>oracle.jdbc.OracleDriver</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 1 from dual</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-while-idle>true</pool-test-while-idle>
    <pool-test-on-borrow>false</pool-test-on-borrow>
  </jdbc-datasource>
</jira-database-config>

4. Jira を起動する

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

 Congratulations, you now have Jira connected to your Oracle database.

既知の問題

• If you start experiencing problems when dealing with custom workflows or working with issues that have long descriptions, comments or custom field values, try adding the element <connection-properties>SetBigStringTryClob=true</connection-properties> as a child of the </jdbc-datasource> element in your dbconfig.xml file. This connection property may solve these problems. You'll need to restart Jira afterwards.