The Project | About Us | Contribute | Donations | License
HOME My courses Completed
◄ Previous
◄

Installing Elasticsearch

Next ►
►

In this section, we will cover the steps required to install Elasticsearch on your system. We will provide instructions for different operating systems, including Windows, macOS, and Linux. By the end of this section, you should have a running instance of Elasticsearch on your machine.

Prerequisites

Before we begin, ensure you have the following prerequisites:

  • Java Development Kit (JDK) 8 or higher installed on your system.
  • Administrative privileges to install software.

Installation Steps

  1. Download Elasticsearch

First, download the latest version of Elasticsearch from the official website: Elasticsearch Downloads.

  1. Install Elasticsearch

Windows

  1. Extract the Downloaded Archive:

    • Download the .zip file from the Elasticsearch website.
    • Extract the contents of the .zip file to a directory of your choice.

  2. Run Elasticsearch:

    • Open a Command Prompt window.
    • Navigate to the bin directory inside the extracted folder.
    • Run the following command: 
      elasticsearch.bat
    • Elasticsearch will start, and you should see log messages indicating that it is running.

macOS

  1. Extract the Downloaded Archive:

    • Download the .tar.gz file from the Elasticsearch website.
    • Open a Terminal window.
    • Extract the contents using the following command: 
      tar -xzf elasticsearch-<version>.tar.gz

  2. Run Elasticsearch:

    • Navigate to the bin directory inside the extracted folder: 
      cd elasticsearch-<version>/bin
    • Run the following command: 
      ./elasticsearch
    • Elasticsearch will start, and you should see log messages indicating that it is running.

Linux

  1. Extract the Downloaded Archive:

    • Download the .tar.gz file from the Elasticsearch website.
    • Open a Terminal window.
    • Extract the contents using the following command: 
      tar -xzf elasticsearch-<version>.tar.gz

  2. Run Elasticsearch:

    • Navigate to the bin directory inside the extracted folder: 
      cd elasticsearch-<version>/bin
    • Run the following command: 
      ./elasticsearch
    • Elasticsearch will start, and you should see log messages indicating that it is running.

  1. Verify Installation

To verify that Elasticsearch is running correctly, open a web browser and navigate to the following URL:

http://localhost:9200

You should see a JSON response similar to the following:

{
  "name" : "your-node-name",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "some-uuid",
  "version" : {
    "number" : "7.x.x",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "some-hash",
    "build_date" : "2021-01-01T00:00:00.000Z",
    "build_snapshot" : false,
    "lucene_version" : "8.x.x",
    "minimum_wire_compatibility_version" : "6.x.x",
    "minimum_index_compatibility_version" : "6.x.x"
  },
  "tagline" : "You Know, for Search"
}

Common Issues and Troubleshooting

  1. Java Not Found

If you encounter an error indicating that Java is not found, ensure that the Java Development Kit (JDK) is installed and the JAVA_HOME environment variable is set correctly.

  1. Port 9200 Already in Use

If port 9200 is already in use, you can change the port by modifying the elasticsearch.yml configuration file located in the config directory. Add the following line:

http.port: 9201

Then restart Elasticsearch.

  1. Insufficient Memory

Elasticsearch requires a significant amount of memory. If you encounter memory-related errors, consider increasing the heap size by setting the ES_JAVA_OPTS environment variable:

export ES_JAVA_OPTS="-Xms2g -Xmx2g"

This sets the minimum and maximum heap size to 2GB.

Conclusion

In this section, we covered the steps to install Elasticsearch on Windows, macOS, and Linux. We also discussed how to verify the installation and troubleshoot common issues. With Elasticsearch up and running, you are now ready to start indexing and searching data, which we will cover in the next module.

◄ Previous
◄
Next ►
►
The Project | About Us | Contribute | Donations | License
© Copyright 2024. All rights reserved