The Elastic Indexer is a command line task runner that synchronizes the Colectica Repository items with an Elasticsearch index.
The Elastic Indexer requires .NET 5 to be installed.
Download and install the Windows .NET Runtime 5.0.x from https://dotnet.microsoft.com/download/dotnet/5.0
Deploy the Elastic Indexer¶
First, make sure Colectica Repository and Colectica Portal are installed.
Populate Colectica Repository with metadata.
Download the Elastic Indexer package. This will be named
ColecticaElasticIndexer-version.zipand should be included with your Colectica Portal delivery.
Before extracting the Elastic Indexer package, make sure Windows does not have the file blocked. To check this:
In Windows Explorer, right click the Zip file and choose Properties.
Near the bottom of the Properties window, in the Security area, see if there is a checkbox labeled Unblock.
If there is an Unblock checkbox, check the box and click OK.
If there is no such checkbox, proceed to the next step.
Extract the contents of the Elastic Indexer package. In this documentation, the directory to which you extract the file will be referred to as
Configure the Elastic Indexer¶
If there is not a file named
appsettings.json, then copy the
appsettings.jsonfile, update the following settings.
- Data - DefaultConnection - ConnectionString
The full connection string of the database to use to store authentication tables, when using Colectica Portal’s built in user management.
- Data - ColecticaRepository - ConnectionString
The full connection string of the Colectica Repository database.
- Elasticsearch - Host
The hostname of the Elasticsearch service.
- Elasticsearch - IndexName
A prefix for any Elasticsearch indices that will be created
The ConnectionString and Elasticsearch settings should match the settings in the Colectica Portal configuration.
Run the Elastic Indexer¶
Open a command shell and navigate to
Run the following command:
Depending on the size of your data, the Elastic Indexer may take a long time to run during the initial ingest. Subsequence runs will only index new content.
Reoccurring task for the Elastic Indexer¶
The Elastic Indexer should be run periodically to index new documents using the Windows Task Scheduler. An interval of 5 minutes is recommended for near real time indexing.
For more information about Windows Task Scheduler, see https://docs.microsoft.com/en-us/windows/win32/taskschd/task-scheduler-start-page