Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel

On this page:

Table of Contents

Target audience:

CAST AI Administrators

Info
Summary: This page explains how to manage the Search index used in the Engineering Dashboard.

Introduction

The Search feature in the Engineering Dashboard uses the open source Lucene search software. Lucene relies on the existence of an index which is generated automatically when the application server is started.

Where is the index located?

The Lucene search index is generated automatically in the following location on disk - the folder and its contents will not exist until the web application server is started for the first time:

Code Block
languagetext
%CATALINA_HOME%\webapps\CAST-Engineering\indexesDirectory
 
or for a combined war:
 
%CATALINA_HOME%\webapps\CAST-Health-Engineering\indexesDirectory

What governs whether the search index is generated?

By default the Engineering Dashboard is set to automatically generate the search index every time the web application server is started. This is governed by a setting in the following file:

Code Block
languagetext
%CATALINA_HOME%\webapps\CAST-Engineering\WEB-INF\web.xml

The setting is set to true by default:

Code Block
languagexml
<context-param>
	<param-name>rebuildComponentsSearchIndexesOnStart</param-name>
	<param-value>true</param-value>
</context-param>

How to disable the automatic search index generation

To disable the automatic search index generation:

  • Edit the following file:
Code Block
languagetext
%CATALINA_HOME%\webapps\CAST-Engineering\WEB-INF\web.xml
  • Change the setting from true to false:
Code Block
languagexml
<context-param>
	<param-name>rebuildComponentsSearchIndexesOnStart</param-name>
	<param-value>false</param-value>
</context-param>
  •  Following any changes you make, save the web.xml file and then restart your application server so that the changes are taken into account.
  • The index will no longer be generated when the web application is started.

How to manually generate the search index

If you have chosen not to have the search index generated automatically when the web application is started, or you want to update the search index without stopping the Engineering Dashboard, you can do so as follows:

Info

Note:

  • all methods require the ADMIN role - see ED - Configuring user authentication.
  • The index will only be updated if the data in it are not up-to-date (eg. a new snapshot has been computed since the last index build)

RestAPI PUT request

You can run the following PUT request to update the index, where My_Domain is equal to the domain you have defined when Installing and configuring the Engineering Dashboard - in most circumstances the domain will be "AED":

Code Block
languagetext
My_Domain/components-index

Using the Diagnostic page

Browse to following location:

Code Block
languagetext
%CATALINA_HOME%\webapps\CAST-Engineering\static\diagnostic.html

Click the Update Index button (click to enlarge) - If the button is greyed out, then the index is already up-to-date:

Image Removed

 

Redirect
visiblefalse
locationDASHBOARDS:Managing the Engineering Dashboard search indexes