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

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

はじめる前に

このページの内容

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>;

    上記に示された権限と完全に一致する権限がユーザーに付与されていることが非常に重要です。Jira ではこれらの権限のみ必要です。適用される権限に過不足がある場合、一部の Jira 機能が正しく動作しない可能性があります。

    Jira の機能が期待どおりに動作するように、ユーザーには特定の権限を付与し、ロールは割り当てないようにすることをお勧めします。

    たとえば、RESOURCE ロールをユーザーに付与し、RESOURCE ロールに SELECT ANY TABLE 権限が付与される場合、Jira の機能は期待どおりに動作しない可能性があります。 

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

  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. Configure your Jira  Server to connect to your Oracle database

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

  • 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.

各設定手法の手順説明

Jira  setup wizard

ブラウザから初めて Jira にアクセスすると、Jira セットアップ ウィザード が表示されます。

  1. 最初の画面 の “Configure Language and Database” で、 “Database Connection” に My own database を選択します。
  2. データベース タイプOracle に設定します。
  3. 下記の データベース接続関連フィールド を参照し、フィールド入力を行います。
  4. 接続をテストし、保存します。

Jira  configuration tool

  1. Run the Jira  configuration tool as follows:
  2. [Database] タブを選択し、”Database type” に ”Oracle” を設定します。
  3. 下記の データベース接続関連フィールド を参照し、フィールド入力を行います。
  4. Test your connection and save. Any custom settings specified while manually configuring Jira  with Oracle (e.g., adding the <connection-properties>SetBigStringTryClob=true</connection-properties>) will be deleted. You will need to reinstate them manually.
  5. Restart Jira .

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

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

<url> タグに配置されます (下記の例の太字部分):<url>jdbc:oracle:thin:@dbserver:1521/ORCL</url>

Oracle サーバーがインストールされたサーバー マシンのマシン名または IP アドレスです。
ポート

<url> タグに配置されます (下記の例の太字部分):
<url>jdbc:oracle:thin:@dbserver:1521/ORCL</url>

Oracle サーバーがリッスンする TCP/IP ポートです。Oracle に設定されたデフォルト ポート番号は “1521” です。
SID

<url> タグに配置されます (下記の例の太字部分):<url>jdbc:oracle:thin:@dbserver:1521/ORCL</url>

Oracle の「システム識別子」です。多くの Oracle サーバーに対するこのデフォルト値は、”ORCL” です。Oracle Express Edition を使用している場合は、”XE” です。
ユーザ名

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

Jira が Oracle サーバーに接続するために使用するユーザー。上記 ステップ 1 で作成しています。

パスワード<password> タグに配置されます (下記の例の太字部分):
<password>jiradbuser</password>
Oracle サーバーが認証に使用するユーザーのパスワードです。

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. Start  Jira

You should now have Jira  configured to connect to your Oracle database. The next step is to start it up!

(tick) 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.
最終更新日 2018 年 5 月 11 日

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

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