Install Elasticsearch 5.0 on RHEL / CentOS
Install Elasticsearch 5.0 on RHEL / CentOS
This article will cover install Elasticsearch 5.x version on CentOS and RHEL distribution. Also guideline to change to Default Cluster and Index settings in Elasticsearch 5.x. So Let’s start with prerequisites
Prerequisites:
As per the recommendation Elasticsearch need 1.8.0_73 or later and only Oracle’s Java and the OpenJDK are supported.
Install Elasticsearch 5.x On RHEL / CentOS using Elasticsearch Repository
Install Public Signing Key:
rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
Create new repo in your /etc/yum.repos.d/ directory. For example I have created elasticsearch.repo here.
/etc/yum.repos.d/elasticsearch.repo
[elasticsearch-5.x] name=Elasticsearch repository for 5.x packages baseurl=https://artifacts.elastic.co/packages/5.x/yum gpgcheck=1 gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch enabled=1 autorefresh=1 type=rpm-md
Now your yum repository ready for use. You can install Elasticsearch 5.0 using below yum command.
yum install elasticsearch
Note: The repositories do not work with older rpm based distributions that still use RPM v3, like CentOS5.
Add Elasticsearch service to start automatically when the system boots up:
chkconfig --add elasticsearch
You can start stop Elasticsearch using service command
service elasticsearch start service elasticsearch stop
Now we have done with Elasticsearch installation. You can check your default Elasticsearch configuration in /etc/elasticsearch/elasticsearch.yml
By default its cluster name will be elasticsearch.
Now we will change Cluster, Index and Host info in elasticsearch.yml
To illustrate here I am naming my Elasticsearch cluster name “Techieroop” and node name “techieroop-es-node“. Add your host into “discovery.zen.ping.unicast.hosts“.
Summary of important Elasticsearch Configuration:
cluster.name: TechieRoop node.name: techieroop-es-node discovery.zen.ping.unicast.hosts: ["127.0.0.1"]
Your elasticsearch.yml will be look like this
# ======================== Elasticsearch Configuration ========================= # # NOTE: Elasticsearch comes with reasonable defaults for most settings. # Before you set out to tweak and tune the configuration, make sure you # understand what are you trying to accomplish and the consequences. # # The primary way of configuring a node is via this file. This template lists # the most important settings you may want to configure for a production cluster. # # Please see the documentation for further information on configuration options: # <https://www.elastic.co/guide/en/elasticsearch/reference/5.0/settings.html> # # ---------------------------------- Cluster ----------------------------------- # # Use a descriptive name for your cluster: # cluster.name: TechieRoop # # ------------------------------------ Node ------------------------------------ # # Use a descriptive name for the node: # node.name: techieroop-es-node # # Add custom attributes to the node: # #node.attr.rack: r1 # # ----------------------------------- Paths ------------------------------------ # # Path to directory where to store the data (separate multiple locations by comma): # #path.data: /path/to/data # # Path to log files: # #path.logs: /path/to/logs # # ----------------------------------- Memory ----------------------------------- # # Lock the memory on startup: # #bootstrap.memory_lock: true # # Make sure that the heap size is set to about half the memory available # on the system and that the owner of the process is allowed to use this # limit. # # Elasticsearch performs poorly when the system is swapping the memory. # # ---------------------------------- Network ----------------------------------- # # Set the bind address to a specific IP (IPv4 or IPv6): # #network.host: 192.168.0.1 # # Set a custom port for HTTP: # #http.port: 9200 # # For more information, see the documentation at: # <https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-network.html> # # --------------------------------- Discovery ---------------------------------- # # Pass an initial list of hosts to perform discovery when new node is started: # The default list of hosts is ["127.0.0.1", "[::1]"] # discovery.zen.ping.unicast.hosts: ["127.0.0.1"] # # Prevent the "split brain" by configuring the majority of nodes (total number of nodes / 2 + 1): # #discovery.zen.minimum_master_nodes: 3 # # For more information, see the documentation at: # <https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-discovery-zen.html> # # ---------------------------------- Gateway ----------------------------------- # # Block initial recovery after a full cluster restart until N nodes are started: # #gateway.recover_after_nodes: 3 # # For more information, see the documentation at: # <https://www.elastic.co/guide/en/elasticsearch/reference/5.0/modules-gateway.html> # # ---------------------------------- Various ----------------------------------- # # Require explicit names when deleting indices: # #action.destructive_requires_name: true
Start the Elasticsearch:
sudo service elasticsearch start
Verify you installation :
curl -XGET 'localhost:9200'
Output:
{ "name" : "techieroop-es-node", "cluster_name" : "Techieroop", "cluster_uuid" : "nmTipFvpSQO3Kp8tXUbDDQ", "version" : { "number" : "5.0.1", "build_hash" : "080bb47", "build_date" : "2016-11-11T22:08:49.812Z", "build_snapshot" : false, "lucene_version" : "6.2.1" }, "tagline" : "You Know, for Search" }
Type | Location | Description |
home | /usr/share/elasticsearch | Home of elasticsearch installation |
bin | /usr/share/elasticsearch/bin | Binary scripts including elasticsearch to start a node. |
conf | /etc/elasticsearch | Configuration files elasticsearch.yml and logging.yml. |
conf | /etc/sysconfig/elasticsearch | Environment variables including heap size, file descriptors. |
data | /var/lib/elasticsearch | Default path to store elasticsearch data . |
logs | /var/log/elasticsearch | Default log location. |
plugins | /usr/share/elasticsearch/plugins | Plugin directory, all plugin installed in separate directory here. |
script | /etc/elasticsearch/scripts | Default script files location. |