在Windows上使用 .zip 安装 ElasticSearch | ElasticSearch 7.7 权威指南中文版

原英文版地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/zip-windows.html, 原文档版权归 www.elastic.co 所有
本地英文版地址: ../en/zip-windows.html

重要: 此版本不会发布额外的bug修复或文档更新。最新信息请参考当前版本文档。

» » » 在Windows上使用.zip安装 Elasticsearch

« 在Linux/MacOS上安装 Elasticsearch 使用 Debian 安装包安装 Elasticsearch »

在Windows上使用`.zip`安装 Elasticsearch

在Windows上可以使用 Windows 的 .zip 归档来安装 Elasticsearch。这带有一个 elasticsearch-service.bat 命令，该命令将设置 Elasticsearch 作为服务运行。

在Windows上，Elasticsearch 一直使用 .zip 归档来安装。一个 MSI安装包为Windows提供了最简单的上入门体验。如果你愿意，你可以继续使用 .zip 方法。

此软件包可在 Elastic 许可下免费使用。它包含开放源码和免费的商业特性，并能访问付费商业特性。开始为期30天的试用尝试使用付费的商业特性。有关 Elastic 许可等级的更多信息，请参考订阅（Subscriptions）页面。

在Windows上，Elasticsearch 的机器学习特性需要 Microsoft Universal C Runtime 库。这个库内置在 Windows10， Windows Server 2016 以及更近期的Windows版本。对于更老版本的Windows，可以通过 Windows Update安装，或者单独下载页面。如果你无法安装 Microsoft Universal C Runtime 库，只要你停用机器学习特性，你仍然可以使用Elasticsearch的其他功能。

Elasticsearch 最新的稳定版本可以在下载 Elasticsearch 页面找到。其他版本可以在过去发布的版本(Past Releases) 页面上找到。

Elasticsearch 包含了一个绑定版本的 OpenJDK，它来自 JDK 维护者(GPLv2+CE)。要使用你自己的Java版本，参考 JVM 版本要求。

下载并安装`.zip`包

从 https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.7.1-windows-x86_64.zip 下载 lasticsearch v7.7.1 版本的 .zip 归档。

或者，你也可以下载这个安装包，其中只包含Apache2.0许可代码：https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.7.1-windows-x86_64.zip

使用你喜欢的解压工具解压它。这会建立一个名为 elasticsearch-7.7.1 的文件夹，并称其为 %ES_HOME%。在终端窗口中，cd 到 %ES_HOME% 目录，比如：

cd c:\elasticsearch-7.7.1

开启自动创建系统索引

一些商业特性会自动在 Elasticearch 中创建索引。默认情况下，Elasticsearch 被配置为允许自动创建索引，并且不需要其他步骤。但是，如果在 Elasticsearch 中禁用了自动索引创建，则必须在 elasticsearch.yml 文件中配置 action.auto_create_index，以允许商业特性创建以下索引：

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

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

从命令行运行 Elasticsearch

Elasticsearch 可以像下面这样从命令行启动：

.\bin\elasticsearch.bat

如果你有密码保护的 ElasticSearch 密钥存储库，系统将提示你输入密钥存储库的密码。更多信息参考安全设置。

默认情况下，Elasticsearch 在前台运行，日志是打印到标准输出(STDOUT)的，并且可以通过按 Ctrl-C来停止运行。

用命令行配置 Elasticsearch

Elasticsearch 默认从 %ES_HOME%\config\elasticsearch.yml 文件加载配置。 配置 Elasticsearch 中解释了此配置文件的格式。

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

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

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

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

检查 Elasticearch 是否正在运行

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

GET /

应该会给你一个类似下面这样的响应：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.7.1",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.5.1",
    "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.7.1\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

服务名称及 JAVA_HOME 的值会在安装过程中给出：

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

虽然 JRE 可以用于 Elasticsearch 服务，但由于它使用客户端虚拟机(而不是为长时间运行的应用程序提供更好性能的服务端 JVM)，因此不鼓励使用它，并将发出警告。

系统环境变量 JAVA_HOME 应该设置为你希望服务使用的 JDK 安装的路径。如果升级了 JDK，不需要重新安装服务，但是你必须设置系统环境变量 JAVA_HOME 的路径为新的 JDK 的安装路径。但是，不支持跨 JVM 类型升级(例如，JRE 与 SE)，并且确实需要重新安装服务。

自定义服务设置

Elasticsearch 服务可以在安装前通过设置以下环境变量进行配置(使用命令行中的set 命令，或通过 系统属性->环境变量 图形用户界面)。

`SERVICE_ID`	服务的唯一标识符。如果在一个机器上安装多个实例，则非常有用。默认值为 `elasticsearch-service-x64`。
`SERVICE_USERNAME`	运行时使用的用户，默认为本地系统账号。
`SERVICE_PASSWORD`	用户 `%SERVICE_USERNAME%` 的密码。
`SERVICE_DISPLAY_NAME`	服务名称。默认值为 `Elasticsearch <version> %SERVICE_ID%`。
`SERVICE_DESCRIPTION`	服务描述。默认为 `Elasticsearch <version> Windows Service - https://elastic.co`。
`JAVA_HOME`	运行服务所需的JVM的安装目录。
`SERVICE_LOG_DIR`	服务日志的目录，默认为 `%ES_HOME%\logs`。请注意，它并不控制 Elasticsearch 日志的路径；这些路径的设置是通过配置文件 `elasticsearch.yml` 中的 `path.logs`，或通过命令行。
`ES_PATH_CONF`	配置文件的目录（它必须包含 `elasticsearch.yml`, `jvm.options`, 和 `log4j2.properties` 文件），默认为 `%ES_HOME%\config`。
`ES_JAVA_OPTS`	你可能希望应用的任何其他 JVM 系统属性。
`ES_START_TYPE`	服务的启动模式。可以是 `auto` 或 `manual` (默认)。
`ES_STOP_TIMEOUT`	procrun 等待服务正常退出的超时时间（单位：秒）。默认值为 `0`。

At its core, elasticsearch-service.bat relies on Apache Commons Daemon project to install the service. 作为它的核心，elasticsearch-service.bat 依赖 Apache Commons Daemon 项目来安装该服务。服务安装前设置的环境变量将被复制，并将应用在服务的生命周期中。这意味着，除非重新安装服务，否则安装后对它们所做的任何更改都不会被接受。

在Windows上，当从命令行运行 Elasticsearch，或者第一次将 Elasticsearch 作为服务安装时，堆内存大小可以像任何其他 Elasticsearch 安装一样进行配置。要调整已安装服务的堆内存大小，请使用服务管理器：bin\elasticsearch-service.bat manager.

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

使用管理器的图形用户界面: 你还可以使用管理器的图形用户界面(elasticsearch-service-mgr.exe)在服务安装后去配置服务，这个界面提供了对已安装服务的详细信息，包括服务的状态、启动类型、JVM、启动和停止设置等。只需从命令行调用elasticsearch-service.bat manager 就能打开管理器窗口：

使用管理器的图形用户界面进行的大多数修改（比如 JVM设置）需要重启服务才能生效。

`.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`
data	节点上的每个索引/分片的数据文件的位置。可以设置多个位置。	`%ES_HOME%\data`	`path.data`
logs	日志文件的存放位置	`%ES_HOME%\logs`	`path.logs`
plugins	插件文件的存放位置。每个插件都放在一个子文件夹中。	`%ES_HOME%\plugins`
repo	共享的文件系统存储库的位置。可以设置多个位置。可以将文件系统存储库放置到此处指定的任何目录的任何子目录中。	未配置	`path.repo`

下一步

你现在已经设置了一个 Elasticsearch 测试环境。在开始正式开发或开始使用 Elasticsearch 进行生产之前，你还必须做一些额外的设置：

« 在Linux/MacOS上安装 Elasticsearch 使用 Debian 安装包安装 Elasticsearch »

在Windows上使用.zip安装 Elasticsearch

下载并安装.zip包

开启自动创建系统索引

从命令行运行 Elasticsearch

用命令行配置 Elasticsearch

检查 Elasticearch 是否正在运行

在 Windows 上将 Elasticsearch 作为服务安装

自定义服务设置

.zip 归档文件的目录结构

下一步

在Windows上使用`.zip`安装 Elasticsearch

下载并安装`.zip`包

`.zip` 归档文件的目录结构