データベース接続のチューニング

接続プールアーキテクチャー

Whenever Jira needs to access (read from or write to) its database, a database connection is required.

A database connection is a large and complex object that handles all communication between Jira and its database. As such, database connections are time-consuming to establish and consume a significant amount of memory on both the client (the Jira application) and the database server.

To avoid the impact of creating a new database connection for each Jira's database access request, a pool of pre-established database connections is maintained. Each new database access request made by Jira uses a connection from this pool of pre-established connections, as required. This results in the following:

1. When Jira starts up, a minimum number of database connections are established in the pool between Jira and its database.
2. When Jira needs to access its database, it:
   
   1. プールに対してデータベース接続を要求します
   2. そのデータベース接続を使用してデータベースの読み出しまたは書き込みを行います
   3. 処理が終了するとデータベース接続をプールに戻す

If the frequency of Jira's database access requests begins to exceed the number of available database connections in the pool, extra connections are automatically created to handle the load.

Conversely, if the frequency of Jira's database access requests begins to drop below the number of available database connections in the pool, connections can be automatically closed to release resources back to the system.

最近のデータベースは十分なメモリーさえあれば数百の接続を比較的簡単に処理できますが、クライアント側ではこれらの接続は大量のメモリーを消費します。そのため、最大接続数をそれよりずっと小さい数に制限して、接続する必要が生じたアプリケーションが待つことなく接続を利用できるようにするのが一般的です。

Tuning Jira's database connections

1. Shut down your Jira installation.
2. 次のいずれかのオプションを選択して進めます。
   
   • Use the Jira configuration tool  to tune Jira 's database connections.
   • Jira ホーム ディレクトリのルートにある dbconfig.xml ファイルを編集します。

Use Jira configuration tool to start Jira 's database connections

1. Start the Jira  configuration tool:
   
   • Windows: コマンド プロンプトを開いて、Jira インストール ディレクトリの bin サブディレクトリにある config.bat を実行します。

   • Linux/Unix: コンソールを開いて、Jira インストール ディレクトリの bin サブディレクトリにある config.sh を実行します。

     このコマンドは「No X11 DISPLAY 変数が原因で Jira アプリケーション設定ツールを起動できなかったのは、設定エラーによるもの」に記載のエラーで失敗する場合があります。その場合は、この記事の回避策をご参照ください。

   
   You may need to set the JAVA_HOME environment variable to run the Jira  configuration tool. See Installing Java  for details.
   
2. Once the Jira configuration tool is running, select the Advanced tab.
   

3. このタブで利用可能なオプションの詳細については「接続プールの設定」をご参照ください。これらのオプションの値を指定するには、先にその一番左のチェックボックスをチェックする必要があります。

   前のスクリーンショットのいくつかのオプションは単純なチェックボックスです。これらのチェックボックスをチェックするとそれに関連するオプションの値が「true」に、逆にチェックを外すとそれに関連するオプションの値が「false」に設定されます。

4. 変更を保存します。これらは要素として dbconfig.xml ファイルに保存されます。

Editing the dbconfig.xml file to start Jira 's database connections

次の手順に従って、Jira ホーム ディレクトリのルートにある dbconfig.xml ファイルを編集します。

1. Refer to the Connection pool settings  for more information about the elements you can add to your  dbconfig.xml file to fine-tune Jira 's database connection.
2. 編集済みの dbconfig.xml ファイルを保存します。
3. Restart your Jira installation.

DBCP 設定

• 設定の既定値は、次のいずれかが実行された後に dbconfig.xml ファイルに書き込まれます。
• Jira セットアップ ウィザードを実行した。
• すべてのオプションで左端のチェックボックスをチェックしていない場合でも、Jira 設定ツールの [詳細設定] タブによってデータベース接続を設定した。
• 設定の既定値で注記「dbconfig.xml で指定されていない場合」が表示された場合は、次のいずれかを意味します。 
• Jira セットアップ ウィザードを実行した後、関連要素が dbconfig.xml ファイルに書き込まれなかった。
• 次のいずれかの方法で、関連要素が dbconfig.xml ファイルに書き込まれた。
• 担当ユーザーが手動で書き込んだ。
• 左端のチェックボックスをチェックしてこれらのオプションの値を設定することで、[詳細設定] タブのオプションに従って指定された。
• 設定の既定値で注記「dbconfig.xml で指定されていない場合」が表示された場合は、dbconfig.xml ファイルに存在しなくてもシステムはこの値を考慮します。

次の表に、すべての接続プール設定とその構成を示します。

接続プールの監視

Jira provides a view of its database connection usage via the Database Monitoring page. See Monitoring database connection usage for more information.