This page last changed on Aug 27, 2009 by ggaskell.

The Content Indexes power Confluence's search functionality and they are also used for a number of related functions such as building email threads in the mail archive, the Space Activity feature and lists of recently-updated content. The Gliffy Plugin also uses them for some of its functionality.

For reasons of efficiency, content is not immediately added to the index. New and modified Confluence content is first placed in a queue and the queue is processed once every minute (by default).

On this page:

Viewing the Content Index Summary

To see information about your Confluence instance's content indexing,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open.
  2. Click 'Content Indexing' under the heading 'Administration' in the left-hand panel.

Screenshot: Index summary

Rebuilding the Content Indexes

The content indexes are maintained automatically, but you may need to rebuild one or both of them manually under circumstances such as these:

  • Your searching and mail threading are malfunctioning. (Rebuild the Search Index.)
  • Your 'Did You Mean' feature is malfunctioning. (Rebuild the Did You Mean Index.)
  • After an upgrade. If a content re-index is required after an upgrade, it will be noted in an upgrade subsection of the relevant release notes.
In new Confluence installations, the 'Did You Mean' feature is not initially activated. To activate it, you first need to build its index by clicking its 'Build' button on this page.

To rebuild either of the content indexes,

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open.
  2. Click 'Content Indexing' under the heading 'Administration' in the left-hand panel.
  3. Click the 'Rebuild' button in either the 'Search Index' or 'Did You Mean Index' sections on this page, depending on the particular index you want to rebuild.
  • If one of these indexes has not yet been built, its button will indicate 'Build' (instead of 'Rebuild').
  • As shown in the image below, only one index can be (re)built at a time.

Screenshot: Content Indexing

Slow Reindexing

Does the reindexing take a long time to complete? The length of time depends on the following factors:

  • Number of pages in your Confluence instance.
  • Number, type and size of attachments.
  • Amount of memory allocated to Confluence.

It may help to increase the heap memory allocation of Confluence by following the instructions in the JIRA documentation.

If you are running an older version of Confluence and find that the index rebuild is not progressing, you may need to shut down Confluence, and restart it with the following Java system property set: bucket.indexing.threads.fixed=1. This will cause the re-indexing to happen in a single thread and be much more stable (but slower).

Viewing the Index Browser

You can access the Lucene index browser used with Confluence, to see if the required documents have been added to the index.

To view the index browser,

  1. Open a browser window.
  2. Log in to Confluence.
  3. Type the following into the browser address bar: <Confluence location>/admin/indexbrowser.jsp.
    For example:
    http://localhost:8080/admin/indexbrowser.jsp
    
  4. You will be asked "Which index would you like to browse?"
  5. Type in the path of your index directory. By default, this is located at <Confluence Home directory/index>.
    For example, c:\confluence\data\index.
  6. You should see a list of indexed file names.

Screenshot: Index Browser

More Hints and Tips

  • If you are still experiencing problems after performing the above rebuild, the next step might be to remove the index and rebuild it from scratch.
    The Space Activity feature uses the index to store data. If you remove the index file, the existing activity data will disappear.
  • A tip for the development community: If you have the Confluence source, you can look for references to the SmartListManager to find the screens and lists that rely on the content index.
RELATED TOPICS
Configuring Indexing Language
Content Index Administration
Creating a Lowercase Page Title Index
Rebuild the Content Indices from scratch
Working with Macros

[!Administration Guide Attachments directory^adminhome.gif!]


ContentIndexing.png (image/png)
IndexBrowser.png (image/png)
IndexSummary.png (image/png)
IndexSummary.png (image/png)
ContentIndexing.png (image/png)
Document generated by Confluence on Nov 05, 2009 23:26