博客

目录

一、Install Elasticsearch from archive on Linux or MacOS

在Linux下载安装压缩包

在MacOS下载安装压缩包

开启系统索引的自动创建

命令行运行Elasticsearch

检察Elasticsearch是否运行

作为守护进程运行

在命令行上配置Elasticsearch

压缩文件目录布局

2、Windows .zip archive

下载安装.zip压缩包

开启系统自动创建索引

通过命令行运行Elasticsearch

命令行配置Elasticsearch

检察Elasticsearch是否运行

作为一个服务在Windows安装Elasticsearch

自定义服务设置

.zip文件目录布局

3、通过Debian包安装Elasticsearch

导入Elasticsearch PGP Key

从APT存储库安装

手动下载并安装Debian包

开启系统自动创建索引

SysV init VS systemd

通过SysV init 运行ElasticSearch

通过systemd 运行ElasticSearch

检察Elasticsearch是否运行

配置Elasticsearch

4、通过RPM安装Elasticsearch

导入Elasticsearch PGP Key

从RPM仓库安装

手动下载并安装Debian包

开启系统自动创建索引

SysV init VS systemd

通过SysV init 运行ElasticSearch

通过systemd 运行ElasticSearch

检察Elasticsearch是否运行

5、使用Windows MSI安装包安装Elasticsearch

使用图形用户界面（GUI）安装

使用命令行安装

6、docker

7、brew

这里提供了官方支持的操作系统和JVM的列表：

支持列表

。Elasticsearch在列出的平台上进行了测试，但它也有可能在其他平台上工作。

Elasticsearch是使用Java构建的，至少需要

Java8

才能运行。只支持Oracle的Java和OpenJDK。所有Elasticsearch节点和客户端上都应使用相同的JVM版本。我们建议安装Java1.8.0_131或更高版本在Java8发行系列中。我们建议使用

受支持

的

LTS版本的Java

。如果使用已知的坏版本Java，Elasticsearch将拒绝启动。

Elasticsearch将使用的Java版本可以通过设置Java_HOME环境变量进行配置。

Elasticsearch可以在我们自己的硬件上运行，也可以在Elastic云上使用我们的托管Elasticsearch服务，该服务可在AWS、GCP和Azure上使用。我们可以免费试用托管服务。

安装我们自己的Elasticsearch，Elasticsearch提供以下格式的包：

一、Install Elasticsearch from archive on Linux or MacOS

这个tar.gz 压缩文件可用于安装在任何Linux发行版和MacOS上

此软件包包含免费和订阅功能。开始为期

30天的试用

，试用所有功能。

Elasticsearch的最新稳定版本可以在

Elasticsearch下载页面

上找到。其他版本可以在

过去的版本页面

上找到。

在Linux下载安装压缩包

Elasticsearch v7.12.0的Linux压缩文件可下载并安装如下：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-linux-x86_64.tar.gz
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-linux-x86_64.tar.gz.sha512
shasum -a 512 -c elasticsearch-7.12.0-linux-x86_64.tar.gz.sha512 
tar -xzf elasticsearch-7.12.0-linux-x86_64.tar.gz
cd elasticsearch-7.12.0/ 

比较下载的.tar.gz压缩文件的SHA和发布的校验和，它应该输出

elasticsearch-{version}-linux-x86_64.tar.gz: OK。


此目录称为$ES_HOME。

在MacOS下载安装压缩包

Elasticsearch v7.12.0的MacOS压缩文件可下载并安装如下：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-darwin-x86_64.tar.gz
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-darwin-x86_64.tar.gz.sha512
shasum -a 512 -c elasticsearch-7.12.0-darwin-x86_64.tar.gz.sha512 
tar -xzf elasticsearch-7.12.0-darwin-x86_64.tar.gz
cd elasticsearch-7.12.0/ 

比较下载的.tar.gz压缩文件的SHA和发布的校验和，它应该输出elasticsearch-{version}-darwin-x86_64.tar.gz: OK

。


此目录称为$ES_HOME。

开启系统索引的自动创建

一些商业功能会在Elasticsearch中自动创建索引。默认情况下，Elasticsearch配置为允许自动创建索引，不需要额外的步骤。但是，如果在Elasticsearch中禁用了自动索引创建，则必须配置action.auto_create_index 在elasticsearch.yml 才能允许商业的功能创建以下索引：

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*

如果我们使用的是Logstash或Beats，那么我们很可能需要在action.auto_create_index 设置额外的索引名，具体值将取决于我们的本地配置。如果不确定环境的正确值，可以考虑将该值设置为*以允许自动创建所有索引。

命令行运行Elasticsearch

Elasticsearch可以从命令行启动，如下所示：

./bin/elasticsearch

如果我们对Elasticsearch密钥库进行了密码保护，系统将提示我们输入密钥库的密码。有关详细信息，请参阅

安全设置

。

默认情况下，Elasticsearch在前台运行，将其日志打印到标准输出（stdout），并且可以通过按Ctrl-C停止。

检察Elasticsearch是否运行

我们可以通过向localhost上的端口9200发送HTTP请求来测试Elasticsearch节点是否正在运行：

GET /

这会给我们一个这样的返回：

{
  "name" : "instance-0000000000",
  "cluster_name" : "9863b7c4eec147e7a9d3729354f68ec1",
  "cluster_uuid" : "V-0cGlUITSq8sdcAB-7rcA",
  "version" : {
    "number" : "7.12.0",
    "build_flavor" : "default",
    "build_type" : "docker",
    "build_hash" : "78722783c38caa25a70982b5b042074cde5d3b3a",
    "build_date" : "2021-03-18T06:17:15.410153305Z",
    "build_snapshot" : false,
    "lucene_version" : "8.8.0",
    "minimum_wire_compatibility_version" : "6.8.0",
    "minimum_index_compatibility_version" : "6.0.0-beta1"
  },
  "tagline" : "You Know, for Search"
}

可以使用命令行上的-q或–quiet选项禁用打印到标准输出的日志。

作为守护进程运行

要作为守护进程运行Elasticsearch，请在命令行中指定-d，并使用-p选项在文件中记录进程ID：

./bin/elasticsearch -d -p pid

日志消息可以在$ES_HOME/logs/directory中找到。

要关闭Elasticsearch，请终止pid文件中记录的进程ID：

pkill -F pid

Elasticsearch .tar.gz包不包括systemd模块。要将Elasticsearch作为服务进行管理，请改用Debian或RPM包。

在命令行上配置Elasticsearch

Elasticsearch默认从$ES_HOME/config/elasticsearch.yml文件下加载它的配置。

Configuring Elasticsearch

中解释了此配置文件的格式。

可以在配置文件中指定的任何设置也可以在命令行中指定，使用-E语法如下：

./bin/elasticsearch -d -Ecluster.name=my_cluster -Enode.name=node_1

通常，任何集群范围的设置（如cluster.name名称)应添加到elasticsearch.yml配置文件，而任何特定于节点的设置，如节点名称可以在命令行上指定。

压缩文件目录布局

压缩文件发行版是完全独立的。默认情况下，所有文件和目录都包含在$ES_HOME中 — 解压缩文件时创建的目录。

这非常方便，因为我们不必创建任何目录就可以开始使用Elasticsearch，卸载Elasticsearch就像删除$ES_HOME目录一样简单。但是，建议更改config目录、data目录和logs目录的默认位置，以便以后不会删除重要数据。

现在我们已经设置了一个测试Elasticsearch环境。在使用Elasticsearch开始正式开发或投入生产之前，必须进行一些额外的设置(后面文章会继续讲)：

• 学习如何配置Elasticsearch
• 配置重要的Elasticsearch设置
• 配置重要的系统设置

2、Windows .zip archive

zip压缩文件适合在Windows上安装。

Elasticsearch可以使用Windows.zip压缩文件安装在Windows上。通过一个elasticsearch-service.bat.bat命令将Elasticsearch设置为作为服务运行。

Elasticsearch过去一直使用.zip压缩文件在Windows上安装。

MSI安装程序包

提供了最简单的Windows入门体验。如果愿意，可以继续使用.zip方法。

下载安装.zip压缩包

从以下网址下载Elasticsearch v7.12.0的.zip存档：

https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-windows-x86_64.zip

用我们最喜欢的解压工具解压。这将创建一个名为elasticsearch-7.12.0的文件夹，我们将其称为%ES_HOME%。在终端窗口中，cd 到%ES_HOME%目录，例如：

cd c:\elasticsearch-7.12.0

开启系统自动创建索引

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*

通过命令行运行Elasticsearch

.\bin\elasticsearch.bat

命令行配置Elasticsearch

.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1

检察Elasticsearch是否运行

GET /

应该返回如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.12.0",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.8.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

作为一个服务在Windows安装Elasticsearch

Elasticsearch可以作为服务安装在后台运行，也可以在引导时自动启动，而无需任何用户交互。这可以通过在 bin\文件夹下的elasticsearch-service.bat脚本，允许用户通过命令行安装、删除、管理或配置服务，并可能启动和停止服务。

c:\elasticsearch-7.12.0\bin>elasticsearch-service.bat

Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]

该脚本需要一个参数（要执行的命令），后跟一个表示服务id的可选参数（在安装多个Elasticsearch服务时很有用）。

服务名称和ES_JAVA_HOME的值在安装期间可用:

c:\elasticsearch-7.12.0\bin>elasticsearch-service.bat install
Installing service      :  "elasticsearch-service-x64"
Using ES_JAVA_HOME (64-bit):  "c:\jvm\jdk1.8"
The service 'elasticsearch-service-x64' has been installed.

虽然JRE可用于Elasticsearch服务，但由于它使用了客户机VM（而不是服务器JVM，后者为长时间运行的应用程序提供更好的性能），因此不鼓励使用它，并将发出警告。

自定义服务设置

可以在安装之前通过设置以下环境变量（使用命令行中的

set command

，或通过System Properties->Environment Variables GUI）来配置Elasticsearch服务。

默认情况下，Elasticsearch会根据节点的角色和总内存自动调整JVM堆的大小。我们建议大多数生产环境采用此默认大小。如果需要，可以通过手动设置堆大小来覆盖默认大小。

在Windows上首次将Elasticsearch安装为服务或从命令行运行Elasticsearch时，可以手动设置堆大小，如设置JVM堆大小所述。要调整已安装服务的堆大小，请使用服务管理器：bin\elasticsearch-service.bat manager。

也可以在manager GUI（elasticsearch-service-mgr.exe）安装以后配置服务，它提供对已安装服务的深入了解，包括其状态、启动类型、JVM、启动和停止设置等。只需要从命令行调用elasticsearch-service.bat  manage 来打开“管理器”窗口：

通过manager GUI进行的大多数更改（如JVM设置）都需要重新启动服务才能生效。

.zip文件目录布局

.zip包是完全独立的。默认情况下，所有文件和目录都包含在%ES_HOME%中 — 解压缩文件时创建的目录。

这非常方便，因为我们不必创建任何目录就可以开始使用Elasticsearch，卸载Elasticsearch就像删除%ES_HOME%目录一样简单。但是，建议更改config目录、data目录和logs目录的默认位置，以便以后不删除重要数据。

3、通过Debian包安装Elasticsearch

deb包适用于Debian、Ubuntu和其他基于Debian的系统。Debian软件包可以从Elasticsearch网站或我们的Debian存储库下载。

导入Elasticsearch PGP Key

我们使用Elasticsearch签名密钥（PGP Key D88E42B4，可从https://pgp.mit.edu 获得)带指纹：

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下载并安装公共签名密钥：

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

从APT存储库安装

在这之前，我们可能需要安装 apt-transport-https 包：

sudo apt-get install apt-transport-https

将存储库定义保存到

/etc/apt/sources.list.d/elastic-7.x.list

:

echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.x.list

我们可以通过以下方式安装Elasticsearch Debian软件包：

sudo apt-get update && sudo apt-get install elasticsearch

如果同一Elasticsearch存储库存在两个条目，则在apt get update期间，您将看到如下错误：

Duplicate sources.list entry https://artifacts.elastic.co/packages/7.x/apt/ ...`

手动下载并安装Debian包

Elasticsearch v7.12.0的Debian软件包可从网站下载并按以下方式安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-amd64.deb
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-amd64.deb.sha512
shasum -a 512 -c elasticsearch-7.12.0-amd64.deb.sha512 
sudo dpkg -i elasticsearch-7.12.0-amd64.deb

开启系统自动创建索引

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*

SysV init VS systemd

安装后Elasticsearch不会自动启动。如何启动和停止Elasticsearch取决于我们的系统是使用SysV init还是systemd（由较新的发行版使用）。我们可以通过运行以下命令来判断正在使用哪个命令：

ps -p 1

通过SysV init 运行ElasticSearch

使用update rc.d命令将Elasticsearch配置为在系统启动时自动启动：

sudo update-rc.d elasticsearch defaults 95 10

可以使用服务命令启动和停止Elasticsearch：

sudo -i service elasticsearch start
sudo -i service elasticsearch stop

如果Elasticsearch由于任何原因无法启动，它会将失败原因打印到STDOUT.日志文件可以在 /var/log/elasticsearch/ 中找到。

通过systemd 运行ElasticSearch

要将Elasticsearch配置为在系统启动时自动启动，请运行以下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

可以使用服务命令启动和停止Elasticsearch：

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

这些命令不提供有关Elasticsearch是否成功启动的反馈。相反，这些信息将写入/var/log/elasticsearch/中的日志文件中。

如果我们的Elasticsearch密钥库受密码保护，则需要使用本地文件和systemd环境变量向systemd提供密钥库密码。此本地文件在存在时应受到保护，一旦Elasticsearch启动并运行，可以安全地将其删除。

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

默认情况下，Elasticsearch服务不会在systemd日志中记录信息。要启用 journalctl 日志记录，必须在elasticsearch.service文件中用ExecStart命令行中删除–quiet选项。

启用systemd日志记录后，可以使用journalctl命令获取日志记录信息：

要跟踪日志：

sudo journalctl -f

要列出elasticsearch服务的日志条目，请执行以下操作：

sudo journalctl --unit elasticsearch

要列出从给定时间开始的elasticsearch服务的日志条目，请执行以下操作：

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

检察Elasticsearch是否运行

GET /

应该返回如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.12.0",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.8.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

配置Elasticsearch

/etc/elasticsearch目录包含Elasticsearch的默认运行时配置。此目录和所有包含文件在安装包设置为root:elasticsearch。

Elasticsearch默认从/etc/Elasticsearch/elasticsearch.yml 加载它的配置。

配置Elasticsearch

中解释了此配置文件的格式。

Debian软件包还有一个系统配置文件（/etc/default/elasticsearch），允许您设置以下参数：

4、通过RPM安装Elasticsearch

rpm软件包适合安装在Red Hat、Centos、SLES、OpenSuSE和其他基于rpm的系统上。RPM可从Elasticsearch网站或我们的RPM存储库下载。

导入Elasticsearch PGP Key

我们使用Elasticsearch签名密钥（PGP Key D88E42B4，可从

https://pgp.mit.edu

获得)带指纹：

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下载并安装公共签名密钥：

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

从RPM仓库安装

创建一个名为elasticsearch.repo的文件在/etc/yum.repos.d/目录用于基于RedHat的发行版，或在/etc/zypp/repos.d/目录中用于基于OpenSuSE的发行版，包含：

[elasticsearch]
name=Elasticsearch repository for 7.x packages
baseurl=https://artifacts.elastic.co/packages/7.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md

我们的存储库已准备就绪。现在可以使用以下命令之一安装Elasticsearch：

sudo yum install --enablerepo=elasticsearch elasticsearch 
sudo dnf install --enablerepo=elasticsearch elasticsearch 
sudo zypper modifyrepo --enable elasticsearch && \
  sudo zypper install elasticsearch; \
  sudo zypper modifyrepo --disable elasticsearch 

1. 在CentOS和旧的基于Red Hat的发行版上使用yum。

2. 在Fedora和其他较新的Red Hat发行版上使用dnf。

3. 在基于OpenSUSE的发行版上使用zypper

默认情况下，已配置的存储库处于禁用状态。这消除了升级系统其余部分时意外升级elasticsearch的可能性。每个安装或升级命令都必须显式地启用存储库，如上面的示例命令所示。

手动下载并安装Debian包

Elasticsearch v7.12.0的RPM可从网站下载并安装如下：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-7.12.0-x86_64.rpm.sha512 
sudo rpm --install elasticsearch-7.12.0-x86_64.rpm

开启系统自动创建索引

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*

SysV init VS systemd

安装后Elasticsearch不会自动启动。如何启动和停止Elasticsearch取决于我们的系统是使用SysV init还是systemd（由较新的发行版使用）。我们可以通过运行以下命令来判断正在使用哪个命令：

ps -p 1

通过SysV init 运行ElasticSearch

使用

chkconfig

命令将Elasticsearch配置为在系统启动时自动启动：

sudo chkconfig --add elasticsearch

可以使用服务命令启动和停止Elasticsearch：

sudo -i service elasticsearch start
sudo -i service elasticsearch stop

如果Elasticsearch由于任何原因无法启动，它会将失败原因打印到STDOUT.日志文件可以在 /var/log/elasticsearch/ 中找到。

通过systemd 运行ElasticSearch

要将Elasticsearch配置为在系统启动时自动启动，请运行以下命令：

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable elasticsearch.service

可以使用服务命令启动和停止Elasticsearch：

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

如果我们的Elasticsearch密钥库受密码保护，则需要使用本地文件和systemd环境变量向systemd提供密钥库密码。此本地文件在存在时应受到保护，一旦Elasticsearch启动并运行，可以安全地将其删除。

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

默认情况下，Elasticsearch服务不会在systemd日志中记录信息。要启用 journalctl 日志记录，必须在elasticsearch.service文件中用ExecStart命令行中删除–quiet选项。

启用systemd日志记录后，可以使用journalctl命令获取日志记录信息：

要跟踪日志：

sudo journalctl -f

要列出elasticsearch服务的日志条目，请执行以下操作：

sudo journalctl --unit elasticsearch

要列出从给定时间开始的elasticsearch服务的日志条目，请执行以下操作：

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

检察Elasticsearch是否运行

GET /

应该返回如下：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.12.0",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.8.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

5、使用Windows MSI安装包安装Elasticsearch

msi软件包适合安装在至少安装了.NET 4.5 framework的Windows 64位系统上，是在Windows上开始Elasticsearch的最简单选择。MSI可从Elasticsearch网站下载。

下载Elasticsearch v7.12.0安装包 from

https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.12.0.msi

使用图形用户界面（GUI）安装

双击下载的.msi包以启动GUI向导，该向导将指导我们完成安装过程。我们可以通过单击？按钮，显示一个侧面板，其中包含每个输入的附加信息：

在第一个屏幕中，选择安装目录。此外，选择数据、日志和配置的放置目录或使用默认位置：

然后根据需要选择是作为服务安装还是手动启动Elasticsearch。作为服务安装时，还可以配置运行服务的Windows帐户、安装后是否应启动服务以及Windows启动行为：

选择要运行服务的Windows帐户时，请确保所选帐户有足够的权限访问所选的安装目录和其他部署目录。还要确保帐户能够运行Windows服务。

公共配置设置在配置部分中公开，除了内存和网络设置之外，还允许设置集群名称、节点名称和角色：

作为安装的一部分，可以下载和安装的常见插件列表，可以选择配置用于下载这些插件的HTTPS代理。确保安装计算机可以访问internet，并且已将任何公司防火墙配置为允许下载从artifacts.elastic.co:

从版本6.3.0开始，默认情况下X-Pack已绑定。除了安全配置和内置用户配置之外，最后一步还允许选择要安装的许可证类型：

单击“安装”按钮后，安装将开始：

…​成功安装时会有提示：

配置管理工具

我们还提供以下配置管理工具来帮助进行大型部署：

1、

Puppet

2、

Chef

3、

Ansible

总结

本篇文章主要就是为了学习各种设置Elasticsearch ,希望对大家有帮助！