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, you must 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, complete the following steps.
- Start the wsadmin client from the following directory of the system on which you installed the deployment manager:
You must start the client from this directory or subsequent commands that you enter do not execute correctly.
- After the wsadmin command environment has initialized, enter the following command to initialize the Search environment and start the Search script interpreter:
When asked to select a server, you can select any server.
- Use the following command to 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.
SearchService.startBackgroundIndex("/opt/IBM/LotusConnections/backgroundIndex", "activities, blogs, communities, dogear, files, forums, profiles, wikis")
Parent topic: Managing the Search index