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.
これは、他のプロセスがインデックスをロックしている場合に発生する可能性があります。考えられる原因は、次のとおりです。
If your logs mention a .lock file the safest solution is too:
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.