在 Windows 上使用 .zip 安装 Elasticsearch

编辑

在 Windows 上使用 .zip 安装 Elasticsearch编辑

可以使用 Windows .zip 存档在 Windows 上安装 Elasticsearch。它附带一个 elasticsearch-service.bat 命令,该命令将设置 Elasticsearch 作为服务运行。

此软件包包含免费和订阅功能。开始 30 天试用 以尝试所有功能。

在 Windows 上,Elasticsearch 机器学习功能需要 Microsoft 通用 C 运行时库。它内置于 Windows 10、Windows Server 2016 和更新版本的 Windows 中。对于旧版本的 Windows,可以通过 Windows 更新或从单独下载安装。如果您无法安装 Microsoft 通用 C 运行时库,则仍然可以使用 Elasticsearch 的其余部分,前提是您禁用了机器学习功能。

可以在下载 Elasticsearch页面上找到 Elasticsearch 的最新稳定版本。可以在过去版本页面上找到其他版本。

Elasticsearch 包含来自 JDK 维护者 (GPLv2+CE) 的OpenJDK的捆绑版本。要使用您自己的 Java 版本,请参阅JVM 版本要求

下载并安装 .zip 软件包编辑

从以下位置下载 Elasticsearch 8.14.2 的 .zip 存档:https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.14.2-windows-x86_64.zip

使用您喜欢的解压缩工具将其解压缩。这将创建一个名为 elasticsearch-8.14.2 的文件夹,我们将将其称为 %ES_HOME%。在终端窗口中,cd%ES_HOME% 目录,例如

cd C:\Program Files\elasticsearch-8.14.2

启用系统索引的自动创建编辑

某些商业功能会在 Elasticsearch 中自动创建索引。默认情况下,Elasticsearch 配置为允许自动创建索引,无需执行任何其他步骤。但是,如果您在 Elasticsearch 中禁用了自动创建索引,则必须在 elasticsearch.yml 中配置action.auto_create_index,以允许商业功能创建以下索引

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

如果您使用的是LogstashBeats,那么您很可能需要在 action.auto_create_index 设置中添加其他索引名称,确切的值将取决于您的本地配置。如果您不确定环境的正确值,可以考虑将该值设置为 *,这将允许自动创建所有索引。

从命令行运行 Elasticsearch编辑

运行以下命令从命令行启动 Elasticsearch

.\bin\elasticsearch.bat

首次启动 Elasticsearch 时,安全功能默认情况下处于启用状态并已配置。以下安全配置将自动执行

  • 启用身份验证和授权,并为 elastic 内置超级用户生成密码。
  • 为传输层和 HTTP 层生成 TLS 证书和密钥,并使用这些密钥和证书启用和配置 TLS。
  • 为 Kibana 生成一个有效期为 30 分钟的注册令牌。

elastic 用户的密码和 Kibana 的注册令牌将输出到您的终端。

建议将 elastic 密码存储为 shell 中的环境变量。示例

$ELASTIC_PASSWORD = "your_password"

如果您已对 Elasticsearch 密钥库进行密码保护,系统将提示您输入密钥库的密码。有关更多详细信息,请参阅安全设置

默认情况下,Elasticsearch 将其日志打印到控制台 (STDOUT) 和 日志目录内的 <集群名称>.log 文件。Elasticsearch 在启动时记录一些信息,但在完成初始化后,它将继续在前台运行,并且不会记录任何其他信息,直到发生值得记录的事情。在 Elasticsearch 运行时,您可以通过其 HTTP 接口与之交互,该接口默认情况下位于端口 9200 上。

要停止 Elasticsearch,请按 Ctrl-C

将节点注册到现有集群编辑

当 Elasticsearch 首次启动时,安全自动配置过程将 HTTP 层绑定到 0.0.0.0,但仅将传输层绑定到 localhost。这种预期行为确保您可以使用默认情况下启用的安全功能启动单节点集群,而无需任何其他配置。

在注册新节点之前,通常需要在生产集群中执行其他操作,例如绑定到除 localhost 之外的地址或满足引导检查。在此期间,自动生成的注册令牌可能会过期,这就是为什么不会自动生成注册令牌的原因。

此外,只有同一主机上的节点才能在没有其他配置的情况下加入集群。如果您希望来自另一台主机的节点加入您的集群,则需要将 transport.host 设置为支持的值(例如,取消对 0.0.0.0 的建议值的注释),或者设置绑定到其他主机可以访问的接口的 IP 地址。有关更多信息,请参阅传输设置

要将新节点注册到您的集群,请使用集群中任何现有节点上的 elasticsearch-create-enrollment-token 工具创建注册令牌。然后,您可以使用 --enrollment-token 参数启动新节点,以便它加入现有集群。

  1. 在与 Elasticsearch 运行的终端不同的终端中,导航到您安装 Elasticsearch 的目录,并运行elasticsearch-create-enrollment-token工具以生成新节点的注册令牌。

    bin\elasticsearch-create-enrollment-token -s node

    复制注册令牌,您将使用它将新节点注册到您的 Elasticsearch 集群。

  2. 从新节点的安装目录启动 Elasticsearch,并使用 --enrollment-token 参数传递注册令牌。

    bin\elasticsearch --enrollment-token <enrollment-token>

    Elasticsearch 会在以下目录中自动生成证书和密钥

    config\certs
  3. 对要注册的任何新节点重复上一步。

在命令行上配置 Elasticsearch编辑

Elasticsearch 默认情况下从 %ES_HOME%\config\elasticsearch.yml 文件加载其配置。此配置文件的格式在配置 Elasticsearch中进行了说明。

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

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

包含空格的值必须用引号括起来。例如 -Epath.logs="C:\My Logs\logs"

通常,任何集群范围的设置(如 cluster.name)都应添加到 elasticsearch.yml 配置文件中,而任何节点特定的设置(如 node.name)都可以在命令行上指定。

检查 Elasticsearch 是否正在运行编辑

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

curl --cacert %ES_HOME%\config\certs\http_ca.crt -u elastic:$ELASTIC_PASSWORD https://127.0.0.1:9200 

确保在您的调用中使用 https,否则请求将失败。

--cacert
HTTP 层生成的 http_ca.crt 证书的路径。

该调用将返回类似于以下内容的响应

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

在 Windows 上安装并运行 Elasticsearch 作为服务编辑

您可以将 Elasticsearch 安装为在后台运行或在启动时自动启动的服务,无需用户交互。

  1. 将 Elasticsearch 安装为服务。服务名称和 ES_JAVA_HOME 的值将在安装期间提供

    C:\Program Files\elasticsearch-8.14.2\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.
  2. 将 Elasticsearch 作为服务启动。当 Elasticsearch 启动时,身份验证默认情况下处于启用状态

    C:\Program Files\elasticsearch-8.14.2\bin>bin\elasticsearch-service.bat start

    当您将 Elasticsearch 作为服务启动时,不会启用或配置 TLS。

  3. 使用elasticsearch-reset-password工具为 elastic 用户生成密码。密码将输出到命令行。

    C:\Program Files\elasticsearch-8.14.2\bin>\bin\elasticsearch-reset-password -u elastic

虽然 JRE 可用于 Elasticsearch 服务,但由于它使用的是客户端 VM(而不是为长时间运行的应用程序提供更好性能的服务器 JVM),因此不建议使用它,并且会发出警告。

系统环境变量 ES_JAVA_HOME 应设置为要使用的 JDK 安装路径。如果您升级了 JDK,则无需重新安装服务,但必须将系统环境变量 ES_JAVA_HOME 的值设置为新 JDK 安装路径。但是,不支持跨 JVM 类型(例如 JRE 与 SE)升级,并且需要重新安装服务。

在 Windows 上管理 Elasticsearch 作为服务编辑

运行 bin\ 文件夹中的 elasticsearch-service.bat 脚本以安装、删除、管理或配置服务,并可能从命令行启动和停止服务。

C:\Program Files\elasticsearch-8.14.2\bin>elasticsearch-service.bat

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

该脚本需要一个参数(要执行的命令),然后是一个可选参数,指示服务 ID(在安装多个 Elasticsearch 服务时很有用)。

可用的命令是

install

将 Elasticsearch 安装为服务

remove

删除已安装的 Elasticsearch 服务(如果已启动,则停止服务)

start

启动 Elasticsearch 服务(如果已安装)

stop

停止 Elasticsearch 服务(如果已启动)。

manager

启动一个用于管理已安装服务的 GUI。

自定义服务设置编辑

可以通过设置以下环境变量来配置 Elasticsearch 服务,以便在安装之前进行配置(可以使用 set 命令 从命令行设置,或通过 系统属性→环境变量 GUI 设置)。

SERVICE_ID

服务的唯一标识符。如果在同一台机器上安装多个实例,则很有用。默认值为 elasticsearch-service-x64

SERVICE_USERNAME

以其运行的用户,默认为本地系统帐户。

SERVICE_PASSWORD

%SERVICE_USERNAME% 中指定的用户密码。

SERVICE_DISPLAY_NAME

服务的名称。默认为 {es} <version> %SERVICE_ID%

SERVICE_DESCRIPTION

服务的描述。默认为 {es} <version> Windows Service - https://elastic.ac.cn

ES_JAVA_HOME

要运行服务的所需 JVM 的安装目录。

SERVICE_LOG_DIR

服务日志目录,默认为 %ES_HOME%\logs。请注意,这不会控制 Elasticsearch 日志的路径;这些日志的路径通过 elasticsearch.yml 配置文件中的 path.logs 设置或在命令行中设置。

ES_PATH_CONF

配置文件目录(需要包含 elasticsearch.ymljvm.optionslog4j2.properties 文件),默认为 %ES_HOME%\config

ES_JAVA_OPTS

您可能想要应用的任何其他 JVM 系统属性。

ES_START_TYPE

服务的启动模式。可以是 automanual(默认)。

ES_STOP_TIMEOUT

procrun 等待服务正常退出所需的超时时间(以秒为单位)。默认为 0

从本质上讲,elasticsearch-service.bat 依赖于 Apache Commons Daemon 项目来安装服务。在服务安装之前设置的环境变量将被复制,并在服务生命周期中使用。这意味着在安装后对它们进行的任何更改都不会被拾取,除非重新安装服务。

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

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

当服务运行时,该服务会自动为 Elasticsearch 配置一个私有的临时目录。此私有的临时目录被配置为运行安装的用户私有临时目录的子目录。如果服务将在不同的用户下运行,则可以在执行服务安装之前将环境变量 ES_TMPDIR 设置为首选位置,以配置服务应使用的临时目录的位置。

使用 Manager GUI
也可以在安装服务后使用 Manager GUI (elasticsearch-service-mgr.exe) 来配置服务,该 GUI 提供对已安装服务的洞察,包括其状态、启动类型、JVM、启动和停止设置等。从命令行调用 elasticsearch-service.bat manager 以打开管理器窗口。

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

将客户端连接到 Elasticsearch编辑

首次启动 Elasticsearch 时,会为 HTTP 层自动配置 TLS。会生成一个 CA 证书并将其存储在磁盘上的以下位置:

%ES_HOME%\config\certs\http_ca.crt

此证书的十六进制编码 SHA-256 指纹也会输出到终端。连接到 Elasticsearch 的任何客户端,例如 Elasticsearch 客户端、Beats、独立的 Elastic Agent 和 Logstash,必须验证它们是否信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agent 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已完成,您仍然可以获取安全证书的指纹。您也可以将 CA 证书复制到您的机器上,并配置您的客户端以使用它。

使用 CA 指纹编辑

将输出到终端的指纹值复制到您的终端,并配置您的客户端以使用此指纹在连接到 Elasticsearch 时建立信任。

如果自动配置过程已完成,您仍然可以通过运行以下命令获取安全证书的指纹。该路径指向 HTTP 层的自动生成的 CA 证书。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令会返回安全证书,包括指纹。issuer 应为 Elasticsearch security auto-configuration HTTP CA

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>
使用 CA 证书编辑

如果您的库不支持验证指纹的方法,则会自动生成的 CA 证书会创建在每个 Elasticsearch 节点的以下目录中:

%ES_HOME%\config\certs\http_ca.crt

http_ca.crt 文件复制到您的机器上,并配置您的客户端以使用此证书在连接到 Elasticsearch 时建立信任。

.zip 存档的目录布局编辑

.zip 包是完全自包含的。默认情况下,所有文件和目录都包含在 %ES_HOME% 中,即解压缩存档时创建的目录。

这非常方便,因为您无需创建任何目录即可开始使用 Elasticsearch,卸载 Elasticsearch 也像删除 %ES_HOME% 目录一样简单。但是,建议更改配置目录、数据目录和日志目录的默认位置,以便您以后不会删除重要数据。

类型 描述 默认位置 设置

home

Elasticsearch 主目录或 %ES_HOME%

解压缩存档时创建的目录

bin

二进制脚本,包括用于启动节点的 elasticsearch 和用于安装插件的 elasticsearch-plugin

%ES_HOME%\bin

conf

配置文件,包括 elasticsearch.yml

%ES_HOME%\config

ES_PATH_CONF

conf

为传输层和 HTTP 层生成的 TLS 密钥和证书。

%ES_HOME%\config\certs

data

在节点上分配的每个索引/分片的 data 文件的位置。

%ES_HOME%\data

path.data

logs

日志文件位置。

%ES_HOME%\logs

path.logs

plugins

插件文件位置。每个插件都将包含在一个子目录中。

%ES_HOME%\plugins

repo

共享文件系统存储库位置。可以包含多个位置。文件系统存储库可以放置在指定目录的任何子目录中。

未配置

path.repo

后续步骤编辑

您现在已经设置了测试 Elasticsearch 环境。在开始进行严肃的开发或将 Elasticsearch 用于生产环境之前,您必须进行一些额外的设置。