Elasticsearch Single Node - In Linux
Starting October 11, 2024 (Zephyr Enterprise 8.2), the Zephyr Enterprise documentation moved from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise documentation page. Please see: https://support.smartbear.com/zephyr-enterprise/docs/en/zephyr-enterprise/zephyr-installation---upgrade-guides/zephyr-on-premise-production-installation/elastic-search/elasticsearch-8-6-2/elasticsearch-single-node---in-linux.html
This section explains the installation and configuration of Elasticsearch (ES) in Linux.
Install and configure ES on HTTP
Installation with tar.gz file
Download Elasticsearch 8.6.2
Unzip the file in a preferred location using the command tar -xvf elasticsearch-8.6.2-linux-x86_64.tar.gz
You need not add configurations in .yml file. The configurations get added in .yml file, once you start the ES.
3. Go to {directory}/elasticsearch-8.6.2/bin folder.
4. Run ES with the ./elasticsearch command.
5. When you run ES in the terminal for the first time, you get a password on the terminal (As default Elasticsearch will run as HTTPS)
Note down the password for future reference.
6. Stop Elasticsearch to make ES run on HTTP
7. Make the changes mentioned in the below sample elasticsearch.yml file.
cluster.name: zephyr
node.name: node-1
http.port: 9200
network.host: 192.168.0.1
xpack.security.enabled: false
xpack.security.enrollment.enabled: false
xpack.security.http.ssl:
enabled: false
xpack.security.transport.ssl:
enabled: false
http.host: 0.0.0.0
indices.query.bool.max_clause_count: 9024
action.auto_create_index: ".watches,.triggered_watches,.watcher-history-*,-zephyr*,+*"
8. Save the changes and start the ES.
9. Check if the ES is started by executing the curl command.
curl -XGET 'http://localhost:9200'
10. Install Zephyr with ES URL http://localhost:9200
Installation with .rmp file
Download Elasticsearch 8.6.2
Install the ES 8.6.2 by using command
yum install elasticsearch-8.6.2-x86_64.rpmOnce ES is installed, the password for built in super user will be displayed as shown in the screen below.
4, To run on HTTP, go to the location of .yml file etc/elasticsearch/elasticsearch.yml
5. To run on HTTP, make the SSL security false. The sample .yml file is as follows:
cluster.name: zephyr
node.name: node-1
path.data: /var/lib/elasticsearch
path.logs: /var/log/elasticsearch
http.port: 9200
network.host: 192.168.0.1
# Enable security features
xpack.security.enabled: false
xpack.security.enrollment.enabled: false
# Enable encryption for HTTP API client connections, such as Kibana, Logstash, and Agents
xpack.security.http.ssl:
enabled: false
keystore.path: certs/http.p12
# Enable encryption and mutual authentication between cluster nodes
xpack.security.transport.ssl:
enabled: false
# Allow HTTP API connections from anywhere
# Connections are encrypted and require user authentication
http.host: 0.0.0.0
8. Start ES.
9. Check ES is installed by executing the cURL command:
10. Install Zephyr application by giving ES URL as http://localhost:9200
Install and Configure ES on HTTPS (with authentication using username and password)
Download Elasticsearch 8.6.2
Unzip the file in a preferred location using the command tar -xvf elasticsearch-8.6.2-linux-x86_64.tar.gz
You need not add configurations in .yml file. The configurations get added in .yml file, once you start the ES.
3. Go to {directory}/elasticsearch-8.6.2/bin folder.
4. Run ES with the ./elasticsearch command.
5. When you run ES in the terminal for the first time, you get a password on the terminal (As default Elasticsearch will run as HTTPS). Note down the password for future reference.
The following is the sample .yml file.
6. Run https://localhost:9200 in browser with default user 'elastic'. Use the ES password that you got in the step 5.
6. Install Zephyr by giving ES URL as
7. Upon successful Zephyr installation, stop the Zephyr and navigate to the
{ZephyrDir}/tomcat/webapps/flex/WEB-INF/classes location.
8. Make changes as mentioned in the below steps, to the
jdbc.properties for ES running on HTTPS.
9. Uncomment elastic.rest.prop.xpack.security.user and change password after colon(:) with the ES password you got after step 4. The default username is “elastic”.
10. Start the Zephyr application after making these changes.
Install and Configure ES on HTTPS (using id and secret key)
Download Elasticsearch 8.6.2
Unzip the file in a preferred location using the command tar -xvf elasticsearch-8.6.2-linux-x86_64.tar.gz
3. Go to {directory}/elasticsearch-8.6.2/bin folder.
4. Run ES with the ./elasticsearch command.
5. When you run ES in the terminal for the first time, you get a password on the terminal (As default Elasticsearch will run as HTTPS). Note down the password for future reference.
The following is the sample .yml file.
6. Execute the below given CURL to generate an API key:
7. Refer to the generated API key response:
8. The <apiKey> would be base64 encoding of id:api_key that is base64 encoding of o3PG-n0Bf9efLymhVjzN:eR9bKD5OTeywOxovC7It2Q
. We can use online utility like this(Base64 Encode and Decode - Online ) for base64 encoding.
9. Install the Zephyr application.
10. Stop Zephyr. Make changes in jdbc.properties file as mentioned below.
Add following properties in jdbc.properties file:
11. Start the Zephyr application.
Enable TLS 1.2 and 1.3 versions for Elasticsearch
You need to add these two lines in the elasticsearch.yml file:
The following is the sample .yml file:
Connect Zephyr to Elasticsearch
Elasticsearch must be running before you install Zephyr Enterprise. You connect Zephyr to ES during the product installation. To do this, specify either the IP address of your ES server, or its host name depending on the settings you have specified in the elasticsearch.yml
file.
Single-node installation
Specifyhttp://192.168.0.1:9200
, orhttp://localhost:9200
when prompted to configure Elasticsearch.
Starting Release 8.2, Zephyr Enterprise documentation is moving from its current location on Atlassian to a dedicated, standalone Zephyr Enterprise Documentation page. https://support.smartbear.com/zephyr-enterprise/docs/en/welcome-to-zephyr-enterprise.html