Create a stand-alone index 

Use the SearchService.startBackgroundIndex command to create a stand-alone index. Using this command helps you to remove inconsistencies from your Search index without the need for downtime while the index is rebuilt.

Before you begin

To use SearchService administrative commands, use the wsadmin client. See Starting the wsadmin client for information about how to start the wsadmin command-line tool.

About this task

The SearchService.startBackgroundIndex command allows you to create a stand-alone index in a specified location. When you use this command, the Search application performs a full crawl of all the specified applications and then builds the index at the specified location. If an index already exists at the location, the crawl resumes from the resume point stored in the Search index at that location.

A file called INDEX.READY is created in the specified location when the background index is complete. At this point, you can replace the existing index with the stand-alone index by manually copying the files over.


To create a stand-alone index...

  1. From the dmgr host:

      cd $DMGR_PROFILE/bin
      ./ -jython

      If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.

  2. Create a background index:

      SearchService.startBackgroundIndex(String indexLocation, String services)

        Creates a stand-alone index in a specified location.

        This command takes two arguments:

        • indexLocation. A string value that specifies the location where you want to create the background index.

        • services. A string value that specifies the names of the applications that you want to include in the index crawl. The following values are valid: activities, blogs, communities, dogear, files, forums, profiles, and wikis.

        For example:

        SearchService.startBackgroundIndex("/opt/IBM/LotusConnections/backgroundIndex", "activities, blogs, communities, dogear, files, forums, profiles, wikis")

Parent topic

Manage the Search index