Installing Elasticsearch

The Elasticsearch is a highly scalable open source full-text search and analytics engine. The feature allows you to store, search, and analyze large volumes of data quickly. The Elasticsearch feature is generally used as the underlying engine or technology that powers applications that have complex search features and requirements.

Before you begin

Fix Pack 7 and earlier
Remember: Starting from IBM® Product Master Fix Pack 8 onwards, Elasticsearch was replaced with OpenSearch due to change in the licensing strategy (no longer open source) by Elastic NV. Thus, you need to install OpenSearch, and run full indexing. For more information, see Installing OpenSearch.
Ensure that you log in as a non-root user in the workstation where you want to install Elasticsearch.
  • You log in as a non-root user.
  • The JAVA_HOME variable is not set.

About this task

This topic describes how to install the Elasticsearch.
Following are the supported versions.
Software Version
Elasticsearch
Fix Pack 7
Elasticsearch 7.17.1
Fix Pack 4 Interim Fix 1
Elasticsearch 7.16.2
Fix Pack 4
Elasticsearch 7.13.0
Fix Pack 1
Elasticsearch 7.7.0
GA
Elasticsearch 5.5.3

Procedure

  1. Download and extract the Elasticsearch.
  2. Set some Operating System level parameters. The following two properties are more commonly set.
    Max virtual memory [vm.max_map_count]
    Needs to be increased to the value of at least 262144. For more information, see Virtual memory.
    Max file descriptors
    Needs to be increased to the value of at least 65536. For more information, see File Descriptors.
  3. Create a dedicated system user to run Elasticsearch service.
  4. Run Elasticsearch service by using the following command.
    ./bin/elasticsearch
  5. Verify that the search service is running through the <http://localhost:9200> URL.
    {
      "name" : "<name>",
      "cluster_name" : "<should match the cluster name specified in the elasticsearch.yml file>",
      "cluster_uuid" : "CxrC0eL4S4yqi-iVCPbXlA",
      "version" : {
        "number" : "x.x.x",
        "build_flavor" : "default",
        "build_type" : "zip",
        "build_hash" : "81a1e9eda8e6183f5237786246f6dced26a10eaf",
        "build_date" : "2020-05-12T02:01:37.602180Z",
        "build_snapshot" : false,
        "lucene_version" : "8.5.1",
        "minimum_wire_compatibility_version" : "6.8.0",
        "minimum_index_compatibility_version" : "6.0.0-beta1"
      },
      "tagline" : "You Know, for Search"
    }

What to do next

Configure Elasticsearch.