Create the initial Search index 

Enable Search functionality by building the index and copying it to each node that is running the Search application.

Before you begin

If you are installing a non-English language deployment and you are creating a Search index for the first time, enable the relevant language dictionaries for your deployment before creating the index. For more information, see Configure dictionaries for Search.

About this task

In IBM Connections 3 and later, each node running the Search application must have the Search index stored locally on the node's file system. This configuration change is required due to limitations with Apache Lucene indexes that are accessed over network shares. Because there are multiple indexes in a clustered environment, they must all be kept in synchronization with each other. During update indexing, documents are first written to a cache table in the HOMEPAGE database and then written to each index across the nodes. When an new index needs to be built, the database cache is skipped, and the crawling and indexing process writes directly to the index directory on the node that is performing the indexing task. After indexing has been completed, the complete index must be copied to the other nodes in the cluster that are running Search. Search functionality is not available until the index is built and deployed to each node. The index is built and ready to be copied when the INDEX.READY and CRAWLING_VERSION files are present in the index directory.

Note: Initial index creation occurs when any scheduled indexing task fires and an index does not yet exist.


  1. Stop all the nodes that are running the Search application. If there are existing search indexes on these nodes, delete them by performing the steps described in Delete the index.

  2. Start one Search node in the cluster.

  3. Wait for the index to be built. You can tell that the index is built when the INDEX.READY and CRAWLING_VERSION files are present in the index directory.

      If you are running Search on a single node only, the task is now complete; you do not need to follow any more of the steps listed. If you are running multiple Search nodes in the cluster, complete the rest of the steps.

  4. Stop the Search node on which the index was built.

  5. Copy the built index directory to the index directory on each node that will be running the Search application.

  6. Start all the nodes.

Parent topic

Mandatory post-installation tasks Related concepts
Configure dictionaries for Search

Related tasks
Delete the index

May 26, 2011


May 26, 2011 1:38:54 PM Added links to related topics. 1 Submitted by Antonio Fiol on May 4, 2011 6:55:20 AM

Re: Creating the initial Search index: ic301

Please add a link to "Deleting the index"