Documentation Center

Configuring Elasticsearch for the search feature with custom file

At install time, before publishing content to be indexed you can use the default bootstrap to define your Elasticsearch engine, or you can follow the steps in this task to replace the default boostrap.json file with your own custom JSON bootstrap file.

About this task

In the default installation, when you first install the IQ Index Service or the IQ Combined Index and Query Services on any machine, you set an installation flag, es.bootstrap.enable=true, to bootstrap the standard Elasticsearch configurations for the search feature using a JSON bootstrap file called bootstrap.json, located in the configuration location of the service.

The default bootstrap file defines three things:
  • the index, udp-index, is used for the actual index for searchable content that was published to Content Delivery. This index is defined by a configuration file referred to by the bootstrap: elasticsearch.json
  • a second index, udp-configuration, is used for storing the configuration of the search itself. This index is defined by two configuration files referred to by the bootstrap: configuration-elasticsearch.json and locale-config.json
  • an Elasticsearch pipeline for extracting information from binary attachments, specified in a file called binary-indexing-pipeline.json
We do not recommend that you edit the configuration-elasticsearch.json or the binary-indexing-pipeline.json files unless you have a pressing reason to do so.

Procedure

  1. To load your own custom JSON bootstrap file instead of the default bootstrap.json file found in the configuration location, place your custom file in the same location and run the service installer with the following switch: --es.bootstrap.file=OTHERFILENAME, where OTHERFILENAME is the name of your custom JSON bootstrap file.
  2. To configure Elasticsearch to your liking, edit the locale-config.json or elasticsearch.json JSON configuration files as needed.