The CLC Server maintains an index of all the elements for each CLC data location. These indexes are used when searching for data elements, and they are also needed for associations between data elements and CLC Metadata tables to be recognized.
Rebuilding the index
Click on the Rebuild Index button next to a data location in the File system locations area under Configuration | Main configuration, to rebuild that location's index. Click on the Rebuild all indexes button to rebuild indexes for all the locations (figure 16.4).
Note: Rebuilding an index can take a long time for locations with a lot of data elements.
When adding a new data location, re-building the index is the default option and indexes are updated with new elements are created or updated. Thus, they are generally expected to be up to date. However, if searches are not returning the results expected, or data associated with CLC Metadata Tables is not being found, then re-indexing can solve those problems.
Important notes when upgrading to version 23.0 from an earlier version
Updates to the search system introduced in version 23.0 require search indexes to be manually built when upgrading from an earlier CLC Server to 23.0 and higher. Until that is done, searches for data in CLC Server data locations will not work, and data associations with CLC Metadata tables stored in CLC Server locations will not be recognized.
New indexes are stored in a folder called
searchindex2 folder, in the installation area of the CLC Server.
Old indexes are not automatically deleted. After building new search indexes, the
searchindex folder in the installation area and its contents can be deleted. That folder contains the old indexes,This can be worth doing if you have data locations with many elements, as indexes for those can take a lot of space.
Notes when moving the CLC Server
If you install the CLC Server on a new system, but are configuring existing directories as CLC Server file locations, you can either:
- Rebuild the index for each data location on the new system, or
- Replace the
searchindex2folder in the installation area of the new setup with the
searchindex2folder from the installation area of the old setup.
Copying the indexes may be preferable if your data locations have many data elements as re-indexing large locations can take some time.
Figure 16.4: The index for each file system location can be rebuilt. This is useful when searching does not return expected results, but can take a long time for locations with many data elements.
Details about indexing operations can be seen in the Audit log, under the Management tab.