2. Install & Configure Elasticsearch

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-and-upgrade-guides/zephyr-on-premise-production-installation/set-up-zephyr-data-center-cluster/2--install-and-configure-elasticsearch.html

To be able to work with Zephyr Data Center, you need to install and configure Elasticsearch -- a search and analytics engine -- on a separate node. Depending on the number of concurrent users who will work with the Data Center, you may need to set up one Elasticsearch node or a cluster of nodes (see Recommended Configurations).

  • The latest Zephyr Enterprise release supports Elasticsearch 8.6.2

  • If you use an Elasticsearch cluster, there is no need to use an external load balancer, as Elasticsearch used in a cluster has the load balancing capability.

To install Elasticsearch on Windows (on a single node or cluster nodes):

  1. Download Elasticsearch 8.6.2 (the ZIP archive).

2. Unzip the downloaded file.

3. Configure the {elasticsearch}\config\elasticsearch.yml file:
For more details on the configuration for-
Single node- refer to the details in ES 8.6.2
Cluster nodes - refer to the details in ES 8.6.2

4. Start the service by running the {elasticsearch}\bin\elasticsearch.bat file.

To install Elasticsearch on Linux (on a single node or on cluster nodes):

1.Download Elasticsearch 8.6.2 (the RPM archive), or run the following command in the Linux command prompt:
For 8.6.2 use the link- wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.6.2-x86_64.rpm

2. In the Linux command prompt, run one of the following commands to install Elasticsearch:
For 8.6.2 - sudo rpm -ivh elasticsearch-8.6.2-x86_64.rpm
sudo yum localinstall elasticsearch-8.6.2-x86_64.rpm

3. Configure the etc\elasticsearch\elasticsearch.yml file:
For more details on configuration for-
Single node- refer to the details in ES 8.6.2
Cluster nodes - refer to the details in ES 8.6.2

4. Start Elasticsearch. The way you start and stop it depends on whether your system uses SysV init or systemd.

If SysV init is used, you start and stop Elasticsearch by running the service command:

sudo -i service elasticsearch start

sudo -i service elasticsearch stop

If systemd is used, you run the following commands:

sudo systemctl start elasticsearch.service

sudo systemctl stop elasticsearch.service

5. Run the following command to verify Elasticsearch is working properly:

curl -XGET '192.168.11.146:9200/_cat/health?v&pretty'


< Prev Step Next Step >

See Also

Set Up Zephyr Data Center
Support and Troubleshooting