# Elasticsearch 7.17.x on Ubuntu 22.04+
## Introduction
This document provides a comprehensive guide for installing **Elasticsearch version 7.17.x** on an Ubuntu 22.04 system. It includes prerequisites, installation steps, configuration, and performance optimization guidelines recommended by OvalEdge.
### Prerequisites
Before proceeding, ensure the following requirements are met:
* **Operating System**: Ubuntu 22.04 LTS or later
* **User Access**: Root or a user with `sudo` privileges
* **Network**: Stable internet connection
* **Java**: Java 17 installed (`openjdk-17-jdk`)
* **Firewall**: Ensure required ports are open (`9200`, `9300`)
### Installation Steps
1. **Elasticsearch Installation**
* **Update Package Index and Enable HTTPS Support**
* Before installing Elasticsearch, update the package index and ensure secure APT transport is enabled:
```bash
sudo apt update -y
sudo apt install apt-transport-https -y
```
\
*Sample Reference Screenshot*
* Create Elasticsearch Repository File
Download and add the GPG key, then configure the repository:
```bash
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
sudo sh -c 'echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" > /etc/apt/sources.list.d/elastic-7.x.list'
```
\
*Sample Reference Screenshot*
* Install Elasticsearch
Run the following commands to install Elasticsearch:
```bash
sudo apt update
sudo apt install elasticsearch -y
```
\
*Sample Reference Screenshot*
* Enable and Start the Service
Enable Elasticsearch to start at boot and then start the service:
```bash
sudo systemctl daemon-reexec
sudo systemctl enable elasticsearch
sudo systemctl start elasticsearch
```
\
*Sample Reference Screenshot*
2. **Java Installation**
* Log in to the Elasticsearch VM and install Java 17:
```bash
sudo apt update -y
sudo apt install -y openjdk-17-jdk
java --version
```
\
*Sample Reference Screenshot*
3. **Elasticsearch Configuration**
* **Configure Elasticsearch Settings**
* Open the Elasticsearch configuration file:
```bash
sudo vi /etc/elasticsearch/elasticsearch.yml
```
Add or update the following parameters:
```yaml
cluster.name: ovaledge
network.host: 0.0.0.0
http.port: 9200
transport.host: localhost
transport.tcp.port: 9300
xpack.security.enabled: true
```
\
*Sample Reference Screenshot*
* **Configure JVM Heap Size**
* Edit the JVM options file:
```bash
sudo vi /etc/elasticsearch/jvm.options
```
Locate the following lines (usually near the top of the file):
```ini
## -Xms4g
## -Xmx4g
```
Uncomment and configure them:
```ini
-Xms4g
-Xmx4g
```
Both values must be set to the same. Recommended value = 50% of available memory.
\
*Sample Reference Screenshot*
* **Restart Elasticsearch**
* Restart the service to apply changes:
```bash
sudo systemctl restart elasticsearch
```
4. **Elasticsearch Passwords**
* **Set Password for Elastic User**
* Run the password reset tool:
```bash
sudo /usr/share/elasticsearch/bin/elasticsearch-reset-password -u elastic -i
```
When prompted:
* Type **y**
* Enter a new password for the `elastic` user
* Confirm the password if requested
*Sample Reference Screenshot*
5. **Verify Installation**
* **Verify Service Availability**
* Use `curl` or a browser to verify Elasticsearch is running:
```bash
curl http://localhost:9200 -u elastic:
```
* Replace `` with the password set previously
* A successful response should display cluster information in JSON format
*Sample Reference Screenshot*
* **Open Firewall Ports (if enabled)**
* If using `firewalld`, open the necessary ports:
```bash
sudo firewall-cmd --permanent --add-port=9200/tcp
sudo firewall-cmd --permanent --add-port=9300/tcp
sudo firewall-cmd --reload
```
6. **Integrate Elasticsearch with OvalEdge**
* **Locate and Edit `oasis.properties`**
* On the OvalEdge application VM, navigate to the `extprop` directory and open the file:
```bash
vi /path/to/ovaledge/extprop/oasis.properties
```
\
\&#xNAN;*Sample Reference Screenshot*
* **Update Elasticsearch Section**
* Configure the following parameters:
```properties
es.host=
es.port=9200
es.protocol=http
es.username=elastic
es.password=
```
\
*Sample Reference Screenshot*
* **Restart Tomcat Service**
* Restart Tomcat to apply the updated configuration:
```bash
sudo systemctl restart tomcat
```
