Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

概要

Indexing in JIRA is performed by Lucene a high-performance, full-featured text search engine library.

ご確認いただきたい内容

JIRA will perform partial re-indexes of the Lucene index after every issue change, this is handled by the Issue Index Listener viewable in Administration > System > Listeners.

It is also possible to run a complete re-index on demand by running a manual re-index from Administration > System > Indexing. From this location you can also specify a new location for JIRA's index files.

インデックス作成における推奨事項

インデックス作成に関する重要な推奨事項は一点です。

重要なポイント

The file path that you specify for JIRA's indexes must be located on a fast local disk.

If JIRA is accessing its indexes across a network drive, Samba or NFS mount you are going to run into indexing exceptions, this would be a likely exception:

2006-03-28 13:06:05,540 ERROR [jira.issue.index.DefaultIndexManager] Giving up reindex - waited 10 seconds
com.atlassian.jira.issue.index.IndexException
...

So you should never run JIRA with this type of configuration.

インデックス作成エラー

ロック例外

これは、他のプロセスがインデックスをロックしている場合に発生する可能性があります。考えられる原因は、次のとおりです。

  • 以前のクリーンではない再起動で残ったロックファイルがディスクにある
  • An old JIRA instance still has threads running; possibly from an earlier JIRA instance that was not entirely shut down when JIRA was last restarted.
  • A process from the current JIRA instance that is taking an unusually long time (10+seconds) finishing.

If your logs mention a .lock file the safest solution is too:

  1. Jira を停止します。
  2. .lock ファイルを削除します。
  3. Jira を再起動します。
  4. インデックスを完全に再作成します。

These lock files (if you are running JIRA standalone) will be in Tomcat's temp directory. If you need some extra information finding these lock files it may help to have a quick read of the F.A.Q. article on the Lucene wiki.

タイムアウト例外

インデックス待ち時間を長くする

If you are seeing exceptions similar to the example above there may be some contention for the lucene indexes. The first option is to increase the allowable timeout for obtaining a lock.

jira-application.properties ファイル、具体的には以下の値を修正してください。

スレッドダンプの取得

JIRA v3.7 and later will automatically perform do a thread dump into the log file in the event of index lock timeouts. If the above does not work and you are still seeing these exceptions it is time to create a support request and attach a thread dump when this error is occurring. Hopefully this thread dump will show what JIRA is currently waiting on to grab the lock on the indexing files.

インデックス作成パフォーマンスが低い

インデックス作成のパフォーマンスが低い場合、レスポンスタイムが遅くなり、インデックスがタイムアウトが発生することがよくあります。インデックスのタイムアウトにより、検索や課題ナビゲーター、ポートレットでの課題結果が一部古くなる可能性があります。

インデックス作成のパフォーマンスが低いのは、一般的にディスクのパフォーマンスの低さに起因していることに注意してください。また、MS Windows でディスクのパフォーマンスが低下する原因として圧倒的に多いのがウィルス対策ソフトであること点も留意してください。ウイルス対策ソフトウェアが無効になっている場合でも、多くのウイルス対策製品がディスク パフォーマンスに深刻な悪影響を及ぼし続ける可能性があることは、多くのお客様にとって当然理解し難いことです。しかし、ウイルス対策ソフトウェアがディスク パフォーマンスや Jira インデックス作成に与える影響を正しく評価するためには、ウイルス対策ソフトウェアを完全にアンインストールすることが必要な場合があります。ウイルス対策製品には、パフォーマンスを低下させる綿密な監視から指定したディレクトリを除外可能なものが多くあります。Jira インデックスディレクトリは、このような除外ディレクトリに指定することが理想的です。

You can use our disk access speed utility to determine if disk performance is a problem for you. Compare the results you get to our published Good results in that page.