Download Elastic Enterprise Search

Version:
7.14.1
Release date:
九月 01, 2021
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

Download and install one of the supported JDKs for Enterprise Search.


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
  4. Start Elasticsearch:
  5. $ bin/elasticsearch
  6. Generate and retrieve a random password for the elastic user and the kibana_system user:
  7. $ 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. elasticsearch.username: elastic
    elasticsearch.password: ELASTIC_USER_PASSWORD
    allow_es_settings_modification: true

    Replace ELASTIC_USER_PASSWORD with the elastic user password generated in step 2.

  4. 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:
  5. 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.

  6. Optionally, if using Kibana, add the Kibana URL to the same config/enterprise-search.yml configuration file:
  7. kibana.external_url: http://localhost:5601

4

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

$ ENT_SEARCH_DEFAULT_PASSWORD=passwordexample bin/enterprise-search

This is an important step. The environment variable ENT_SEARCH_DEFAULT_PASSWORD is only used once by Enterprise Search to provision the default enterprise_search user password the first time the product starts.


5

Setting up Kibana (if you want to access Enterprise Search via Kibana)

  1. Download the current version of Kibana and navigate to the uncompressed directory.
  2. Locate config/kibana.yml and add the following configuration:

    elasticsearch.username: kibana_system
    elasticsearch.password: KIBANA_SYSTEM_USER_PASSWORD
    enterpriseSearch.host: http://localhost:3002

    Replace KIBANA_SYSTEM_USER_PASSWORD with the kibana_system user password generated in step 2.

  3. Start Kibana:
    $ bin/kibana

6

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.

OR

Log in to Kibana to access Enterprise Search by opening http://localhost:5601. Log in using the enterprise_search username and the password previously specified at start time. After logging in to Kibana, choose Enterprise Search to navigate to the Elastic Enterprise Search Home area.


7

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.