Elasticsearch 7.17.x on Amazon Linux

This article provides a comprehensive guide for installing Elasticsearch 7.17.x on Ubuntu 22.04 and Amazon Linux. It includes prerequisites, installation steps, configuration instructions, and integration with the OvalEdge application.

Hardware Requirements

• Memory: Minimum 4 GB RAM (8 GB recommended)

• CPU: Minimum 2 vCPUs

• Disk Space: Minimum 10 GB free

Prerequisites

• User account with sudo privileges

• Stable internet connection

• Java 17 installed (Amazon Corretto or OpenJDK). Elasticsearch 7.17.x requires Java 17.

Elasticsearch Installation (Amazon Linux)

Follow the steps below to install and start Elasticsearch 7.x on Amazon Linux.

Install Java 17

• Elasticsearch requires Java 17. Use Amazon Corretto 17:

  Copy

  sudo yum install java-17-amazon-corretto -y

  

  Copy

  java -version

  
• If Java is already installed and java -version returns a supported version, skip this step.

Import the GPG Key

• Add the Elastic GPG key for the Elasticsearch repository:

  Copy

  sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

  

Create Elasticsearch Repository

• Create the elasticsearch.repo file in the /etc/yum.repos.d/ directory on RedHat-based systems.

  Copy

  sudo vi /etc/yum.repos.d/elasticsearch.repo

  
• Add the following content:

  Copy

  [Elasticsearch-7]
  name=Elasticsearch repository for 7.x packages
  baseurl=https://artifacts.elastic.co/packages/7.x/yum
  gpgcheck=1
  gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
  enabled=1
  autorefresh=1
  type=rpm-md

  

Install Elasticsearch

• Update packages and install Elasticsearch:

  Copy

  sudo yum update -y
  sudo yum install elasticsearch -y

  

Enable and Start Elasticsearch

• Start the Elasticsearch service after installation.

• Reload the systemd manager configuration to recognize the new service:

  Copy

  sudo systemctl daemon-reload

• Enable Elasticsearch on boot:

  Copy

  sudo systemctl enable elasticsearch.service

  
• Start and verify status:

  Copy

  sudo systemctl start elasticsearch.service
  sudo systemctl status elasticsearch.service

  
• Ensure the status shows active (running) before proceeding.

Configure Elasticsearch

Elasticsearch requires configuration updates to define cluster settings, enable network access, and activate security features.

Edit elasticsearch.yml

• Edit the elasticsearch.yml file in the /etc/elasticsearch/ directory to configure Elasticsearch.

  Copy

  sudo vim /etc/elasticsearch/elasticsearch.yml

• Append or modify:

  Copy

  cluster.name: ovaledge
  network.host: 0.0.0.0
  transport.host: localhost
  transport.tcp.port: 9300
  http.port: 9200
  xpack.security.enabled: true
  cluster.name: Logical name for the Elasticsearch cluster.
  network.host: Binds the HTTP service to all available network interfaces.
  xpack.security.enabled: Enables built-in security features including authentication and TLS.

Restart Elasticsearch

• Restart the Elasticsearch Service.

  Copy

  sudo systemctl restart elasticsearch.service

  
• Verify it responds on port 9200

  Copy

  curl http://localhost:9200

Set Up Password for Elastic User

Elasticsearch includes built-in reserved users that require password configuration. These users are used by various components within the Elastic Stack for authentication and internal communication.

• Navigate to the bin directory:

  Copy

  cd /usr/share/elasticsearch/bin

• Run password setup:

  Copy

  sudo ./elasticsearch-setup-passwords interactive

• When prompted, type y to continue.

• Enter and confirm a secure password for each built-in user (e.g., elastic, kibana, logstash_system).

• For simplicity and manageability, the same password can be used for all users, but this is optional.

  

  Record these credentials securely. The elastic user credentials will be required for integrating Elasticsearch with other applications such as OvalEdge.

Integration with OvalEdge

To integrate Elasticsearch with the OvalEdge application, update the relevant configuration in the oasis.properties file located on the OvalEdge application server.

Edit oasis.properties

• Navigate to extprop directory:

  Copy

  cd /<path_to_ovaledge>/extprop
  sudo vi oasis.properties

• Configure Elasticsearch Connection Parameters

  • If Elasticsearch is on the same VM: es.host=localhost

  • If on another VM: Replace <elasticsearch_host> with its IP or hostname

  • Add the elasticsearch user password configured during the Elasticsearch setup.

    

Restart Tomcat

• Restart OvalEdge application:

  Copy

  sudo systemctl restart tomcat

• Ensure Elasticsearch is running and accessible before restarting Tomcat.

Copyright © 2025, OvalEdge LLC, Peachtree Corners, GA, USA.