Jira アプリケーションの Oracle への接続
1. Oracle の設定
- Jira で利用できるデータベース インスタンスがあることをご確認ください (新規作成、または既存インスタンスの使用)。
そのデータベース インスタンス内で、Jira が接続時に使用するユーザーを作成します (例:
jiradbuser)。
このデータベース ユーザー名は、次のステップでこのデータベースへの Jira の接続を設定するために使用するため、必ず覚えておいてください。create user <user> identified by <user_pass> default tablespace tablespace_name> quota unlimited on <tablespace_name>;Oracle でユーザーを作成すると、次のようになります。
- Oracle は「スキーマ」を自動で作成します。
表オブジェクトの表領域を指定する必要があります。
ユーザーが次の権限を持つことを確認します。
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 の機能は期待どおりに動作しない可能性があります。そのため、上記の権限を正確にユーザーに付与することをお勧めします。- データベースに設定された文字エンコードが Jira と同じであることを確認します。推奨されるエンコードは AL32UTF8 (Oracle における Unicode UTF-8 と同等のエンコード) です。
2. Oracle JDBC ドライバのダウンロード
次の手順に従って、ご利用の Oracle バージョンに適した JDBC ドライバーをダウンロードします。
- Oracle JDBC ドライバーをダウンロードします。
- ダウンロードした
.jarファイルを Jira インストール ディレクトリのlib/ディレクトリにコピーします。
サポート対象ドライバーの詳細は「サポート対象プラットフォーム」をご参照ください。
3. Oracle データベースに接続するための Jira Server の設定
Oracle データベースに接続するために JIRA サーバーを設定する方法は２つあります。
- Jira セットアップ ウィザードを使用する。Jira をインストールしたばかりで初めてセットアップする場合は、この方法を使用します。設定は Jira ホーム ディレクトリの
dbconfig.xmlファイルに保存されます。 - Jira 設定ツールを使用する。既存の Jira インスタンスがある場合は、この方法を使用します。設定は Jira ホーム ディレクトリの
dbconfig.xmlファイルに保存されます。
セットアップ ウィザードによる Jira の設定
ブラウザーで Jira に初めてアクセスすると、Jira セットアップ ウィザードが表示されます。
- 最初に表示される [言語とデータベースを設定] 画面で、[データベース接続] を [ご自分のデータベース] に設定します。
- データベース タイプを Oracle に設定します。
- 「データベース接続フィールド」セクションをご参考のうえ、フィールドに入力します。
- 接続をテストし、保存します。
設定ツールによる Jira の設定
- Jira 設定ツールを次のように実行します。
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
binサブディレクトリにあるconfig.batを実行します。 Linux/Unix: コンソールを開いて、Jira インストール ディレクトリの
binサブディレクトリにあるconfig.shを実行します。このコマンドは「No X11 DISPLAY 変数が原因で Jira アプリケーション設定ツールを起動できなかったのは、設定エラーによるもの」に記載のエラーで失敗する場合があります。その場合は、この記事の回避策をご参照ください。
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
- [データベース] タブを選択して [データベース タイプ] を [Oracle] に設定します。
- 「データベース接続フィールド」セクションをご参考のうえ、フィールドに入力します。
- 接続をテストし、保存します。Jira と Oracle を手動で設定したときに指定したすべてのカスタム設定 (例:
<connection-properties>SetBigStringTryClob=true</connection-properties>の追加) は削除されます。削除された設定は手動で回復させる必要があります。 - Jira を再起動します。
データベース接続フィールド
| セットアップ ウィザード/設定ツール | dbconfig.xml | 説明 |
|---|---|---|
| ホスト名 |
| Oracle サーバーがインストールされたサーバー マシンのマシン名または IP アドレスです。 |
| ポート |
| Oracle サーバーがリッスンする TCP/IP ポート。Oracle の既定のポート番号は「1521」です。 |
| SID |
| Oracle の「システム識別子」。ほとんどの Oracle サーバーで既定値は「ORCL」です。Jira は Oracle データベース Express エディションでは動作しないことにご注意ください。 |
| ユーザ名 |
| Jira が Oracle サーバーに接続するために使用するユーザー。このユーザーはこのガイドのステップ 1 で作成しています。 |
| パスワード | <password> タグに格納されます (下記例の太字部分):<password> jiradbuser </password> | Oracle サーバーが認証に使用するユーザーのパスワード。 |
dbconfig.xml ファイルのサンプル
上記の dbconfig.xml ファイルに含まれる、pool で始まる <jdbc-datasource/> の子要素の詳細については、「データベース接続のチューニング」を参照してください。
<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>
<connection-properties>defaultRowPrefetch=200</connection-properties>
<pool-test-while-idle>true</pool-test-while-idle>
<pool-test-on-borrow>false</pool-test-on-borrow>
</jdbc-datasource>
</jira-database-config>
Jira セットアップ ウィザードとデータベース設定ツールの両方も、dbconfig.xml ファイルに要素 <validation-query>select 1</validation-query> を追加します。これは通常、既定の MySQL インストールで Jira を実行する場合に必要です。詳細については、「コネクション切断の問題を乗り越える方法」をご参照ください。
4. Jira を起動する
これで、Oracle データベースに接続するための Jira の設定が完了しました。次のステップでは、Jira を起動します。
おつかれさまでした、これで Oracle データベースへの Jira の接続は完了です。
既知の問題およびトラブルシューティング
- カスタム ワークフローを扱う際や、長い説明、コメント、またはカスタム フィールド値を持つ課題で作業する際に問題が発生した場合は、
dbconfig.xmlファイルで<connection-properties>SetBigStringTryClob=true</connection-properties>要素を</jdbc-datasource>要素の子要素として追加することをお試しください。この接続プロパティによって、発生した問題が解決する可能性があります。設定後に Jira を再起動する必要があります。 - Oracle JDBC ドライバーが JVM の言語設定に従って接続の照合順序を設定することを考慮します。このため、特定の言語 (ドイツ語やフランス語など) では、Oracle 接続の照合順序が、予想される "バイナリ" と異なる可能性があります。この理由から、データベースの結果が予想外の順序でソートされることがあります。また、Jira でヘルス チェックの警告がトリガーされる可能性もあります。トラブルシューティングのヒントについては、Oracle のナレッジ ベースをご確認ください。