Elasticsearch is the default search engine for Liferay DXP 7.0. The Liferay
Foundation suite includes an adapter for Elasticsearch called Liferay Portal
Search Elasticsearch. The adapter is configurable through System Settings or an
OSGi configuration file named
and deployed to
The list below is all the configuration settings for Liferay’s default Elasticsearch 2.x adapter, in the order they appear in the System Settings application:
- A String value that sets the name of the cluster to integrate with. This name should match the remote cluster when Operation Mode is set to remote. (See also: remote operation mode)
- There are two operation modes you can choose from: EMBEDDED or REMOTE. Set to REMOTE to connect to a remote standalone Elasticsearch cluster. Set to EMBEDDED to start Liferay with an internal Elasticsearch instance. Embedded operation mode is unsupported for production environments.
- Set a String value to use as the prefix for the search index name. The default value should not be changed under normal conditions. If you change it, you must also perform a reindex all operation for the portal and then manually delete the old index using the Elasticsearch administration console.
- A boolean setting that, when set to
true, tries to lock the process address space into RAM, preventing any Elasticsearch memory from being swapped out (see here) for more information)
- A boolean setting that, when set to true, only logs exceptions from Elasticsearch, and does not rethrow them.
- Set an int value for the number of retries to attempt if a version conflict occurs because the document was updated between getting it and updating it (see here for more information).
- Set a String value for the range of ports to use when building the value for discovery.zen.ping.unicast.hosts. Multiple Elasticsearch nodes on a range of ports can act as gossip routers at the same computer (see here for more information).
- Set this String value to instruct the node to bind to this hostname or IP address and publish (advertise) this host to other nodes in the cluster. This is a shortcut which sets the bind host and the publish host at the same time (see here for more information).
- Set the String value of the network interface(s) a node should bind to in order to listen for incoming requests (see here for more information).
- Set the String value of a single interface that the node advertises to other nodes in the cluster, so that those nodes can connect to it (see here for more information).
- Set the String value for the port to bind for communication between nodes. Accepts a single value or a range (see here for more information).
- Set the String values for the addresses of the remote Elasticsearch nodes to connect to. This value is required when Operation Mode is set to remote (see here for more information). Specify as many or few nodes as you see fit.
- Set this booleant to true to enable cluster sniffing and dynamically discover available data nodes in the cluster (see here for more information).
- Set this boolean to true to ignore cluster name validation of connected nodes (see here for more information).
- Set this String value to instruct the client node on how often to sample / ping the nodes listed and connected (see here for more information).
- Set this boolean to false to disable the http layer entirely on nodes which are not meant to serve REST requests directly (see here for more information).
- Set this boolean to false to disable cross-origin resource sharing, i.e. whether a browser on another origin can do requests to Elasticsearch. If disabled, web front end tools like elasticsearch-head may be unable to connect (see here for more information).
- Set the String origins to allow when HTTP CORS is enabled (see here for more information).
- Set the String values for custom settings for HTTP CORS, in YML format (elasticsearch.yml) (see here for more information).
- Set the String values for custom settings for embedded Elasticsearch, in YML format. See: Adding Settings to the Liferay Elasticsearch Adapter
- Set the String values for custom settings for the Liferay index, in JSON or YML format (refer to the Elasticsearch Create Index API for more information). See: Adding Settings to the Liferay Elasticsearch Adapter
- Set the String values for custom mappings for the
LiferayDocumentType, in JSON format (refer to the Elasticsearch Put Mapping API for more information) See: Adding Settings to the Liferay Elasticsearch Adapter
The following settings are only available in the Elasticsearch 6 adapter:
- Set the String value for how many replica shards each primary shard has.
- Set the String value for the number of primary shards an index has.
- Set the String value for how long to wait for a node’s ping response.
Configurations only Affecting the Embedded Elasticsearch Server
These settings (defined above) are only meant to use while configuring the embedded Elasticsearch server. Configuring these will elicit no effect on remote Elasticsearch installations:
You can easily configure these settings in the System Setting application, or
as mentioned above, you can specify them in a deployable OSGi