Jira アプリケーションの Oracle への接続
1. Oracle の設定
- Jira で利用できるデータベース インスタンスがあることをご確認ください (新規作成、または既存インスタンスの使用)。
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 サーバーを設定する方法は2つあります。
- Jira セットアップ ウィザードを使用する。Jira をインストールしたばかりで初めてセットアップする場合は、この方法を使用します。設定は Jira ホーム ディレクトリの
dbconfig.xml
ファイルに保存されます。 - Jira 設定ツールを使用する。既存の Jira インスタンスがある場合は、この方法を使用します。設定は Jira ホーム ディレクトリの
dbconfig.xml
ファイルに保存されます。
セットアップ ウィザードによる Jiraby の設定
ブラウザーで 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>
<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 の設定が完了しました。次のステップでは、これを起動させます。
おつかれさまでした、これで Oracle データベースへの JIRA の接続は完了です。
既知の問題およびトラブルシューティング
- If you face 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 yourdbconfig.xml
file. This connection property may solve the encountered problems. You'll need to restart Jira afterward. - Consider that the Oracle JDBC driver sets the collation for the connection according to the language settings for the JVM. Because of this, for certain languages (for example German or French), the collation for the Oracle connection can be other than the expected “BINARY". For this reason, database results might be sorted in an unexpected order, and it can also trigger a health check warning in Jira. Check the Oracle knowledge base for troubleshooting tips.