使用windows安装包安装 Elasticsearch

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

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

» » »

« 使用RPM安装包安装 Elasticsearch 用Docker安装 Elasticsearch »

此功能目前处于 beta 测试阶段，可能会有变化。设计和代码不如官方的 GA 功能成熟，而且是按原样提供的，没有保障。 Beta版特性不受官方 GA 特性的 SLA 支持。

msi 安装包适合在 Windows 上安装 Elasticsearch。这可以将 Elasticsearch 安装为 Windows 服务，或者允许使用内含的可执行文件 elasticsearch.exe手动运行之。

Elasticsearch 历史上一直使用 .zip 存档安装。如果你愿意，你可以继续使用 .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 版本要求。

下载 `.msi` 安装包

从 https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.7.1.msi 下载 lasticsearch v7.7.1 版本的 .msi 安装包。

使用图形用户界面(GUI)安装

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

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

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

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

常见配置设置显示在 Configuration 部分，除了内存和网络设置之外，还允许设置集群名称、节点名称和角色:

作为安装的一部分，提供了一个可以下载和安装的常见插件列表，可以选择配置一个 HTTPS 代理来下载这些插件。

确保安装机器可以访问互联网，并且公司的任意一个防火墙都配置为允许从 artifacts.elastic.co 下载：

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

X-Pack 包含一个 Trail（试用）或基本（Basic）许可证。 Trail（试用）许可证可以使用 30 天，之后你可以获得一个可用的订阅。基本（Basic）许可证是永久免费的。有关哪个许可证下有哪些可用的特性的更多信息，请参考可用的订阅页面。

点击安装按钮后，安装就开始了：

... 安装成功后会显示如下:

使用命令行安装

还可以从命令行执行 .msi 来安装 Elasticsearch。使用与图形用户界面相同的默认值的最简单的安装是先进入下载目录，然后运行命令:

msiexec.exe /i elasticsearch-7.7.1.msi /qn

默认情况下，msiexec.exe 不会等到安装程序执行完成，因为它是运行在 Windows子系统下的。要等待进程完成并确保 %ERRORLEVEL% 被相应地设置，建议使用 start /wait 创建一个进程并等待它退出。

start /wait msiexec.exe /i elasticsearch-7.7.1.msi /qn

与任意一个 MSI 安装包一样，安装过程的日志文件可以在%TEMP%目录中找到，随机生成的日志文件名遵循 MSI<random>.LOG 格式。可以使用命令行参数 /l 显示日志文件的路径：

start /wait msiexec.exe /i elasticsearch-7.7.1.msi /qn /l install.log

可以使用下面的命令行来显示所有支持的 Windows Installer 的命令行参数：

msiexec.exe /help

...或者参考 Windows Installer开发套件命令行选项。

命令行选项

GUI 中显示的所有设置也可以作为命令行参数(在Windows Installer文档中称为properties)使用，这些参数可以传递给 msiexec.exe:

`INSTALLDIR`	安装目录。路径中最后一个目录必须是 Elasticsearch 的版本。默认为 `%ProgramW6432%\Elastic\Elasticsearch\7.7.1`
`DATADIRECTORY`	数据存储的目录。默认为 `%ALLUSERSPROFILE%\Elastic\Elasticsearch\data`
`CONFIGDIRECTORY`	配置存放的目录。默认为 `%ALLUSERSPROFILE%\Elastic\Elasticsearch\config`
`LOGSDIRECTORY`	日志存放的目录。默认为 `%ALLUSERSPROFILE%\Elastic\Elasticsearch\logs`
`PLACEWRITABLELOCATIONSINSAMEPATH`	数据、配置和日志目录是否应该创建在安装目录下。默认 `false`
`INSTALLASSERVICE`	是否要将 Elasticsearch 安装并配置为 Windows 服务。默认 `true`
`STARTAFTERINSTALL`	是否在安装完成后启动 Windows 服务。默认 `true`
`STARTWHENWINDOWSSTARTS`	是否在 Windows 启动时启动这个服务。默认 `true`
`USELOCALSYSTEM`	安装的服务是否以本地系统账号(LocalSystem Account)运行。默认 `true`
`USENETWORKSERVICE`	安装的服务是否以网络服务账号(NetworkService Account)运行。默认 `false`
`USEEXISTINGUSER`	安装的服务是否以一个指定的已有的账号运行。默认 `false`
`USER`	安装的Windows服务运行的账号名称。默认为 `""`
`PASSWORD`	安装的Windows服务运行的账号的密码。默认为 `""`
`CLUSTERNAME`	集群名称。默认为 `elasticsearch`
`NODENAME`	节点名称。默认为 `%COMPUTERNAME%`
`MASTERNODE`	Elasticsearch 是否被配置为主节点(master node)。默认为 `true`
`DATANODE`	Elasticsearch 是否被配置为数据节点(data node)。默认为 `true`
`INGESTNODE`	Elasticsearch 是否被配置为预处理节点(ingest node)。默认 `true`
`SELECTEDMEMORY`	给 Elasticsearch 的 JVM 堆分配的内存大小。默认 `2048`，如果目标机器的总内存少于 4GB 则此默认值为总内存的50%。
`LOCKMEMORY`	是否应该使用 `bootstrap.memory_lock` 来尝试进程地址空间(process address space) 锁定到RAM。默认为 `false`
`UNICASTNODES`	用于单播发现(unicast discovery) 的一个逗号分割的主机列表，格式为 `host:port` 或 `host`。默认为 `""`
`MINIMUMMASTERNODES`	为了形成集群，必须可见的符合主节点的最小节点数量。默认为 `""`
`NETWORKHOST`	绑定到此节点的主机名或IP地址，并会发布(publish)(公告,advertise)到集群中的其他节点的主机。默认为 `""`
`HTTPPORT`	通过 HTTP 公开 Elasticsearch API 服务的端口。默认为 `9200`
`TRANSPORTPORT`	集群的节点之间进行内部沟通的端口。默认为 `9300`
`PLUGINS`	安装时选择要下载和安装的插件列表，以逗号分割。默认为 `""`
`HTTPSPROXYHOST`	下载插件时是用的 HTTPS 代理主机。默认为 `""`
`HTTPSPROXYPORT`	下载插件时是用的 HTTPS 代理的端口。默认为 `443`
`HTTPPROXYHOST`	下载插件时是用的 HTTP 代理主机。默认为 `""`
`HTTPPROXYPORT`	下载插件时是用的 HTTP 代理的端口。默认为 `80`
`XPACKLICENSE`	要安装的许可证的类型，`Basic` 或者 `Trial`。默认为 `Basic`
`XPACKSECURITYENABLED`	当使用 `Trial` 许可证安装时，是否启用安全特性。默认为 `true`
`BOOTSTRAPPASSWORD`	当安装时使用 `Trial` 许可证且启用了安全特性，用于引导集群并以 `bootstrap.password` 存储到秘钥库中的密码。默认是一个随机值。
`SKIPSETTINGPASSWORDS`	当安装时使用 `Trial` 许可证且启用了安全特性，安装程序是否应该跳过设置内置用户。默认为 `false`
`ELASTICUSERPASSWORD`	当安装时使用 `Trial` 许可证且启用了安全特性，内置用户`elastic`的密码。默认为 `""`
`KIBANAUSERPASSWORD`	当安装时使用 `Trial` 许可证且启用了安全特性，内置用户`kibana`的密码。默认为 `""`
`LOGSTASHSYSTEMUSERPASSWORD`	当安装时使用 `Trial` 许可证且启用了安全特性，内置用户`logstash_system`的密码。默认为 `""`

要传递一个值，可以简单的按 <PROPERTYNAME>="<VALUE>" 格式把属性名称及其值附加到安装命令上。比如，要使用不同于默认安装目录的安装目录：

start /wait msiexec.exe /i elasticsearch-7.7.1.msi /qn INSTALLDIR="C:\Custom Install Directory{version}"

有关包含引号的值的其他规则，参考 Windows Installer SDK 命令行选项。

开启自动创建系统索引

一些商业特性会自动在 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.exe

命令行终端会显示类似下面这样的信息：

默认情况下，Elasticsearch 在前台运行，日志是打印到LOGSDIRECTORY目录下的文件名为 <cluster name>.log 的标准输出(STDOUT)，并且可以通过按 Ctrl-C来停止运行。

用命令行配置 Elasticsearch

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

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

.\bin\elasticsearch.exe -E cluster.name=my_cluster -E node.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可以作为服务安装在后台运行，也可以在启动时自动启动，无需任何用户交互。这可以通过在安装时使用以下命令行选项来实现:

INSTALLASSERVICE=true
STARTAFTERINSTALL=true
STARTWHENWINDOWSSTARTS=true

安装好后，Elasticsearch 就会出现的服务控制面板中：

且可以通过控制面板来停止和重启，或者像下面这样从命令行操作：

使用命令行提示符：

sc.exe stop Elasticsearch
sc.exe start Elasticsearch

使用 PowerShell：

Get-Service Elasticsearch | Stop-Service
Get-Service Elasticsearch | Start-Service

在服务安装后，可以通过jvm.options 和配置文件 elasticsearch.yml 来修改设置。大多数修改（比如 JVM 设置）需要重启服务才能生效。

使用图形用户界面(GUI) 升级

.msi 安装包支持升级一个已安装的版本到新的版本。在通过 GUI 升级的过程中，它会处理所有已安装插件的升级，并保留你的数据和配置。

下载并双击新版本的 .msi 安装包，就会启动 GUI 安装向导。第一步会列出之前已安装版本的只读选项：

下一步会允许你修改部分配置选项：

最后，插件操作步骤中允许你将已安装的插件升级或者移除，对于尚未安装的插件，可以下载并安装：

通过命令行升级

.msi 安装包还可以使用命令行来升级 Elasticsearch。

命令行升级需要传递与首次安装时 相同的 命令行属性；Windows 安装程序不会记住这些属性。

比如，如果你之前是以命令行选项 PLUGINS="ingest-geoip" 和 LOCKMEMORY="true" 来安装的，那么你从命令行执行升级时必须传递相同的值。

参数 INSTALLDIR（如果原来指定了）是一个例外，这各值必须使用与当前安装版本不同的目录。如果指定了 INSTALLDIR，路径的最后一个目录必须包含必须是版本号，比如：

C:\Program Files\Elastic\Elasticsearch\7.7.1

最简单的升级方式是，假设 Elasticsearch 是使用所有的默认值安装的，首先导航到下载目录，然后运行:

start /wait msiexec.exe /i elasticsearch-7.7.1.msi /qn

与安装过程类似，可以通过命令行参数 /l 来指定升级过程的日志存放的路径：

start /wait msiexec.exe /i elasticsearch-7.7.1.msi /qn /l upgrade.log

使用添加/删除程序卸载 Elasticsearch

.msi 安装包处理安装时建立的所有文件夹和文件夹的卸载工作。

卸载程序会移除安装时建立的所有内容， 除了数据、配置和日志目录。建议在升级前给数据目录做个备份，或者使用快照(snapshot) API。

MSI 安装包没有提供卸载的 GUI。已安装的程序，可以通过按 Windows 徽标键然后输入 添加或删除程序 来打开设置管理。

打开后，在已安装应用的列表中找到 Elasticsearch，点击并选择 卸载：

这将启动卸载程序。

使用命令行卸载 ElasticSearch

卸载 ElasticSearch 还可以使用命令, 先切换到包含 .msi 安装包的目录，然后执行：

start /wait msiexec.exe /x elasticsearch-7.7.1.msi /qn

与安装过程类似，可以通过命令行参数 /l 来指定卸载过程的日志存放的路径：

start /wait msiexec.exe /x elasticsearch-7.7.1.msi /qn /l uninstall.log

下一步

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

« 使用RPM安装包安装 Elasticsearch 用Docker安装 Elasticsearch »