Download Elastic Enterprise Search

7.12 introduces significant storage savings and you may need to prepare your instance before upgrading. Learn more.

Version:
7.12.1
Release date:
April 27, 2021
License:
Elastic License
Downloads:
Containers:
Notes:

Refer to the detailed App Search documentation and Workplace Search Documentation for more information about deployment, operation, and maintenance.

Not the Enterprise Search version you're looking for? View past releases.

View the detailed release notes here.

Installation steps

1

Prerequisites

Make sure Java 8 or Java 11 is installed and available.

2

Setting up Elasticsearch

You'll need to get Elasticsearch up and running with security features enabled:


  1. Download the current version of Elasticsearch and navigate to the uncompressed directory.
  2. Locate config/elasticsearch.yml and add the following configuration:
    3. xpack.security.enabled: true
    xpack.security.authc.api_key.enabled: true
  3. Start Elasticsearch:
    4. $ bin/elasticsearch
  4. Generate and retrieve a random password for the elastic user:
    5. $ bin/elasticsearch-setup-passwords auto
Note

You may also manually generate passwords using the elasticsearch-setup-passwords command.

3

Setting up Elastic Enterprise Search


  1. Download the current version of Elastic Enterprise Search, and navigate to the uncompressed directory.
  2. Locate config/enterprise-search.yml and add the following configuration:
    3. ent_search.auth.source: standard
    elasticsearch.username: elastic
    elasticsearch.password: ELASTIC_USER_PASSWORD
    allow_es_settings_modification: true
  3. You must also set at least one encryption key in the same config/enterprise-search.yml configuration file (256-bit key recommended) as an array:
    4. secret_management.encryption_keys: [ENCRYPTION_KEY_1, ENCRYPTION_KEY_2, ...]
Note

For more information on encryption keys for Enterprise Search, refer to the configuration guide.

4

Start Enterprise Search by specifying a password for the default enterprise_search user:

$ ENT_SEARCH_DEFAULT_PASSWORD=passwordexample bin/enterprise-search

5

Log in to the Elastic Enterprise Search experience at http://localhost:3002 using the enterprise_search username and the password previously specified at start time.

6

From the Elastic Enterprise Search Home area, select the product experience that fits your use case best.

Need help choosing the best product for your needs?
Learn more about Elastic App Search and Elastic Workplace Search.

7

Explore the Elastic App Search documentation and the Elastic Workplace Search documentation, and get searching!