Full text: Elasticsearch

enaio® 10.10 »

Elasticsearch is installed via elasticsearch_setup.exe under \Backend\Elasticsearch in the installation data.

A linguistic plugin for optimizing the search in the following languages is included: German, English, French, Spanish, and Italian. You can integrate licenses for additional languages later on. The plug-is enabled for German by default.

Version 7.16.2. of Elasticsearch will be installed.

The installation directory, the HTTP port for Elasticsearch (default: 8041), and the index directory for the index data cluster configuration parameter are specified here:

Node name

The node name may contain letters, digits, '-', and '_'.

Initial node names

The initial master node names are the names of all nodes that can be the master node that are already installed or will be installed. At least one is required. If there are multiple nodes, three are recommended.

Connection parameters to the master nodes

IP address and ports for all servers with master nodes that are already installed or will be installed.

Master node

Data node
Generally, all nodes serve as master and data nodes.

For management and updating, the index directory must not be located below the installation directory and it must provide sufficient space for the large index database.

We recommend having disk space available with a minimum of 25% of the size required for all text documents to be indexed in the system, taking into account the expected data growth.

Recommended optimizations will temporarily require additional disk space in shard size.

The index directory should be on a logical drive with high performance and fast access. Elasticsearch recommends using an SSD hard drive.

However, it should be created on the computer where the full-text server is installed.

Elasticsearch requires an administrator service account.

If you have questions about dimensioning, contact the OPTIMAL SYSTEMS support or consulting team.

The directory for the index data can be subsequently changed using the path.data parameter in the following configuration file:


For example: path.data: 'C:\VTX\db'

Full text is configured via the 'index' and 'search' services in enaio® services-admin and in enaio® enterprise-manager.

Services URL: <service-manager-IP>:<Port>

After installation, check if the following entry is present in the configuration file elasticsearch.yml:
script.painless.regex.enabled: true
If not, add this entry.


The following steps are necessary after installation:

  1. Start Elasticsearch.
  2. Run the elasticsearch-set-initial-passwords.bat batch file from the \bin installation directory.
  3. Open the built-in.usr file from the \config installation directory.
  4. Copy the password of the user 'elastic'.
  5. Insert the password in the application-es.yml file in the \services\service-manager\config directory as the password of the user 'elastic': elasticsearch.pwd: password
  6. Save the file and if necessary restart the 'index' and 'search' services.

Upgrading to version 10 from versions 8.50 and 9.0 of enaio® requires reinstalling Elasticsearch 7.9.3 and migrating of existing index data.

Service Configuration

To call up the configuration for the Elasticsearch, launch elasticsearch-7-service-x64w.exe in the \elasticsearch7\bin installation directory.

Linguistic Plug-in

The linguistic plug is enabled for German by default. Enable and disable languages using the index-prod.yml configuration file located in the \config directory of enaio® service-manager:

  languages: 'de'

Enter an abbreviation for the language you need into the configuration file: German – de, English – en, French – fr, Spanish – es, or Italian – it. You can integrate licenses for multiple and additional languages later on.