在 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 的最新稳定版本。可以在过去版本页面上找到其他版本。
下载并安装 .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*
从命令行运行 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
参数启动新节点,以便它加入现有集群。
-
在与 Elasticsearch 运行的终端不同的终端中,导航到您安装 Elasticsearch 的目录,并运行
elasticsearch-create-enrollment-token
工具以生成新节点的注册令牌。bin\elasticsearch-create-enrollment-token -s node
复制注册令牌,您将使用它将新节点注册到您的 Elasticsearch 集群。
-
从新节点的安装目录启动 Elasticsearch,并使用
--enrollment-token
参数传递注册令牌。bin\elasticsearch --enrollment-token <enrollment-token>
Elasticsearch 会在以下目录中自动生成证书和密钥
config\certs
- 对要注册的任何新节点重复上一步。
在命令行上配置 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
该调用将返回类似于以下内容的响应
{ "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 安装为在后台运行或在启动时自动启动的服务,无需用户交互。
-
将 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.
-
将 Elasticsearch 作为服务启动。当 Elasticsearch 启动时,身份验证默认情况下处于启用状态
C:\Program Files\elasticsearch-8.14.2\bin>bin\elasticsearch-service.bat start
当您将 Elasticsearch 作为服务启动时,不会启用或配置 TLS。
-
使用
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 服务时很有用)。
可用的命令是
|
将 Elasticsearch 安装为服务 |
|
删除已安装的 Elasticsearch 服务(如果已启动,则停止服务) |
|
启动 Elasticsearch 服务(如果已安装) |
|
停止 Elasticsearch 服务(如果已启动)。 |
|
启动一个用于管理已安装服务的 GUI。 |
自定义服务设置编辑
可以通过设置以下环境变量来配置 Elasticsearch 服务,以便在安装之前进行配置(可以使用 set 命令 从命令行设置,或通过 系统属性→环境变量 GUI 设置)。
|
服务的唯一标识符。如果在同一台机器上安装多个实例,则很有用。默认值为 |
|
以其运行的用户,默认为本地系统帐户。 |
|
在 |
|
服务的名称。默认为 |
|
服务的描述。默认为 |
|
要运行服务的所需 JVM 的安装目录。 |
|
服务日志目录,默认为 |
|
配置文件目录(需要包含 |
|
您可能想要应用的任何其他 JVM 系统属性。 |
|
服务的启动模式。可以是 |
|
procrun 等待服务正常退出所需的超时时间(以秒为单位)。默认为 |
从本质上讲,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 主目录或 |
解压缩存档时创建的目录 |
|
bin |
二进制脚本,包括用于启动节点的 |
|
|
conf |
配置文件,包括 |
|
|
conf |
为传输层和 HTTP 层生成的 TLS 密钥和证书。 |
|
|
data |
在节点上分配的每个索引/分片的 data 文件的位置。 |
|
|
logs |
日志文件位置。 |
|
|
plugins |
插件文件位置。每个插件都将包含在一个子目录中。 |
|
|
repo |
共享文件系统存储库位置。可以包含多个位置。文件系统存储库可以放置在指定目录的任何子目录中。 |
未配置 |
|
后续步骤编辑
您现在已经设置了测试 Elasticsearch 环境。在开始进行严肃的开发或将 Elasticsearch 用于生产环境之前,您必须进行一些额外的设置。
- 了解如何 配置 Elasticsearch。
- 配置 重要的 Elasticsearch 设置。
- 配置 重要的系统设置。