Elasticsearch requires configuration and settings file changes to be made consistently across the Elasticsearch cluster.
...
Note |
---|
Caution
|
Elasticsearch Config File
Info |
---|
Version differencesThe Elasticsearch configuration settings have changed with each major release. See Elasticsearch Configuration Differences to track how these configuration settings have changed since Elasticsearch 2.3.3. |
Edit the Elasticsearch config file: /etc/elasticsearch/elasticsearch.yml
action.auto_create_index: "+csmeter*,+*_nfsconnector,.watches, | Needed to disable automatic index creation, csmeter indices, and Swarm NFS connectors. (v10.1) | |||||
cluster.name: <ES_cluster_name> | Provide the Elasticsearch cluster a unique name, which is unrelated to the Swarm cluster name. Do not use periods in the name.
| |||||
node.name: <ES_node_name> | Optional: Elasticsearch supplies a node name if one is not set. Do not use periods in the name. | |||||
network.host: _site_ | Assign a specific hostname or IP address, which requires clients to access the ES server using that address. Update | |||||
cluster.initial_master_nodes | (ES 7+) For first-time bootstrapping of a production ES cluster. Set to an array or comma-delimited list of the hostnames of the master-eligible ES nodes whose votes should be counted in the very first election. | |||||
discovery.zen. | (ES 6 only) Set to (number of master-eligible nodes / 2, rounded down) + 1. Prevents split-brain scenarios by setting the minimum number of ES nodes online before deciding on electing a new master. | |||||
discovery.seed_hosts | (ES 7+) Enables auto-clustering of ES nodes across hosts. Set to an array or comma-delimited list of the addresses of all master-eligible nodes in the cluster. | |||||
discovery.zen.ping.unicast.hosts: ["es0", "es1"] | (ES 6 only) Set to the list of node names/IPs in the cluster, verifying all ES servers are included. Multicast is disabled by default. | |||||
gateway.expected_nodes: 4 | Add and set to the number of nodes in the ES cluster. Recovery of local shards starts as soon as this number of nodes have joined the cluster. It falls back to the | |||||
gateway.recover_after_nodes: 2 | Set to the minimum number of ES nodes started before going into operation status:
| |||||
bootstrap.memory_lock: true | Set to lock the memory on startup to verify Elasticsearch does not swap (swapping leads to poor performance). Verify enough system memory resources are available for all processes running on the server. The RPM installer makes these edits to
| |||||
path.data: <path_to_data_directory> | path.data goes to
| |||||
thread_pool.write.queue_size | The size of the queue used for bulk indexing. This variable was called | |||||
node.attr.rack | Optional: A setting for Elasticsearch that tells to not assign the replica shard to a node running in the same “rack” where the primary shard lives. This allows for example a 6-node cluster running with 2 nodes on each of 3 ESXi hosts to survive one of the ESXi hosts being down. The state is yellow, not red. Set to a rack name or ESXi host identifier like Ideally, this is set right after initial configuration when first starting Elasticsearch. To add to an existing deployment, all nodes must be restarted before shards are reallocated. To do this without downtime, first turn off shard allocation, then restart each node one by one waiting for it to show in |
...
Create the override file.
Code Block language bash /etc/systemd/system/elasticsearch.service.d/override.conf
Add this content.
Code Block language bash [Service] LimitMEMLOCK=infinity # Uncomment below line if elasticsearch fails to start with the JNA warning: # [WARN ][o.e.b.Natives ] unable to load JNA native support library # Environment=ES_TMPDIR=/usr/share/elasticsearch/tmp
Load the override file; otherwise, the setting does not take effect until the next reboot.
Code Block language bash sudo systemctl daemon-reload
If Elasticsearch fails to start with the JNA warning ([WARN ][o.e.b.Natives ] unable to load JNA native support library
) in the log, immediately after “memory locking” warnings, then the customer should change the tmpdir setting in jvm.options.
...
language | bash |
---|
...
Environment Settings
Edit the environmental settings: /etc/sysconfig/elasticsearch
...