Jira アプリケーションの Oracle への接続
1. Oracle の設定
- Ensure that you have a database instance available for Jira — either create a new one or use an existing one.
Within that database instance, create a user which Jira will connect to. For example,
jiradbuser.
Make sure that you remember this database user name as it will be used to configure Jira's connection to this database in the following steps.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>;It is critically important that the user is granted the exact privileges as 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
RESOURCErole to a user, and theRESOURCErole grants theSELECT ANY TABLEprivilege, then Jira functions may not work as expected. Thus, we recommend that you grant the exact privileges to the user instead.- Ensure that the 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 ドライバのダウンロード
次の手順に従って、ご利用の Oracle バージョンに適した JDBC ドライバーをダウンロードします。
- Oracle JDBC ドライバーをダウンロードします。
- Copy the downloaded
.jarfile to thelib/directory in the Jira installation directory.
サポート対象ドライバーの詳細は「サポート対象プラットフォーム」をご参照ください。
3. Configure your Jira Server to connect to your Oracle database
Oracle データベースに接続するために JIRA サーバーを設定する方法は２つあります。
- By 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.xmlfile in your Jira home directory. - By using the Jira configuration tool. Use this method if you have an existing JIRA instance. The settings will be saved to the
dbconfig.xmlfile in your Jira home directory.
Configuring Jiraby using the setup wizard
You'll see the Jira setup wizard when you access Jira for the first time in your browser.
- 最初に表示される [言語とデータベースを設定] 画面で、[データベース接続] を [ご自分のデータベース] に設定します。
- データベース タイプを Oracle に設定します。
- 「データベース接続フィールド」セクションをご参考のうえ、フィールドに入力します。
- 接続をテストし、保存します。
Configuring Jira by using the configuration tool
- Run the Jira configuration tool as follows:
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
binサブディレクトリにあるconfig.batを実行します。 Linux/Unix: コンソールを開いて、Jira インストール ディレクトリの
binサブディレクトリにあるconfig.shを実行します。このコマンドは「No X11 DISPLAY 変数が原因で Jira アプリケーション設定ツールを起動できなかったのは、設定エラーによるもの」に記載のエラーで失敗する場合があります。その場合は、この記事の回避策をご参照ください。
- Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの
- [データベース] タブを選択して [データベース タイプ] を [Oracle] に設定します。
- 「データベース接続フィールド」セクションをご参考のうえ、フィールドに入力します。
- 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. - Jira を再起動します。
データベース接続フィールド
| セットアップ ウィザード/設定ツール | dbconfig.xml | 説明 |
|---|---|---|
| ホスト名 |
| Oracle サーバーがインストールされたサーバー マシンのマシン名または IP アドレスです。 |
| ポート |
| Oracle サーバーがリッスンする TCP/IP ポート。Oracle の既定のポート番号は「1521」です。 |
| SID |
| Oracle の「システム識別子」。ほとんどの Oracle サーバーで既定値は「ORCL」です。Jira は Oracle データベース Express エディションでは動作しないことにご注意ください。 |
| ユーザ名 |
| The user that Jira uses to connect to the Oracle server. You should have created this user in Step 1 of this guide. |
| パスワード | <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. Start Jira
You should now have Jira configured to connect to your Oracle database. The next step is to start it up!
Congratulations, you now have Jira connected to your Oracle database.
既知の問題およびトラブルシューティング
- 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.xmlfile. This connection property may solve the encountered problems. You'll need to restart Jira afterward. - Oracle JDBC ドライバーが JVM の言語設定に従って接続の照合順序を設定することを考慮します。このため、特定の言語 (ドイツ語やフランス語など) では、Oracle 接続の照合順序が、予想される "バイナリ" と異なる可能性があります。この理由から、データベースの結果が予想外の順序でソートされることがあります。また、Jira でヘルス チェックの警告がトリガーされる可能性もあります。トラブルシューティングのヒントについては、Oracle のナレッジ ベースをご確認ください。