本文只介绍在windows上的安装和配置,其他安装和配置请参见官方文档
ES在windows上安装需下载zip安装包,解压后bin目录下有个 elasticsearch-service.bat 文件。运行此文件ES就会启动服务。
Elasticsearch需要Java 8或更高版本。
具体安装请参见Elasticsearch和Kibana安装
在命令行中配置ES
约定:以后我们把解压后的目录存放地址称作 %ES_HOME% ,比如 D:ProgramFileselasticsearch-5.4.1
ES默认从 %ES_HOME%configelasticsearch.yml 文件加载配置。具体配置请参考 Configuring Elasticsearch.
只要能在配置文件中指定的配置,在命令行中也能实现。像下面这样使用 -E 语法:
.inelasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1
包含空格的值必须用引号括起来,比如 -Epath.logs="C:My Logslogs"。
通常,集群范围内的设置(如cluster.name
)应该在elasticsearch.yml
配置文件中配置,而任何特定于节点的设置(如node.name),可以在命令行中指定。
检查ES是否正在运行
发送一个http请求到9200端口,比如 http://localhost:9200/ 。或者在kibana中执行 GET /
会返回以下内容:
{ "name": "9fzvF2H", "cluster_name": "elasticsearch", "cluster_uuid": "xBoSQEYqQSaJjzzpmAj7aw", "version": { "number": "5.4.1", "build_hash": "2cfe0df", "build_date": "2017-05-29T16:05:51.443Z", "build_snapshot": false, "lucene_version": "6.5.1" }, "tagline": "You Know, for Search" }
在windows上安装ES服务
ES可以作为服务安装,在后台运行,也可以在系统启动时自动启动,无需任何用户交互。通过 %ES_HOME% 下的bin目录下的elasticsearch-service.bat
脚本来实现,该脚本可以从命令行安装,删除,管理或配置服务并潜在地启动和停止服务。
c:elasticsearch-5.4.1in>elasticsearch-service Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]
该脚本需要一个参数(要执行的命令),然后是一个可选的指示服务的标识(在安装多个ES服务时很有用)。
可用的命令有:
|
作为服务安装ES |
|
删除已安装的ES服务(如果启动则停止服务) |
|
启动ES服务(如果已安装) |
|
停止ES服务(如果启动) |
|
启动GUI来管理已安装的服务 |
根据安装的java JDK / JRE架构,将安装适当的64位(x64)或32位(x86)服务。
D:ProgramFileselasticsearch-5.4.1in>elasticsearch-service install Installing service : "elasticsearch-service-x64" Using JAVA_HOME (64-bit): "D:ProgramFilesJavajdk1.8.0_131" The service 'elasticsearch-service-x64' has been installed.
虽然JRE可用于Elasticsearch服务,但由于是客户端VM(而不是为长期运行应用程序提供更好性能的服务器JVM),因此不鼓励使用它,并而且会发出警告。
应将环境变量JAVA_HOME设置为要使服务使用的JDK的安装路径。如果升级JDK,则不需要重新安装服务,但必须将JAVA_HOME
为设置为新JDK安装的路径。不支持跨JVM类型升级(例如JRE与SE),而且需要重新安装该服务。
自定义服务设置
ES服务在安装前可以设置以下环境变量,可以在命令行中使用 set 命令,也可以直接在环境变量中配置。
|
服务的唯一标识. 对于在同一台机器上安装多个ES服务很有用.默认为 |
|
使用服务的用户名称, 默认为本机账户. |
|
用户为 |
|
服务的名称,默认为 |
|
对服务的描述.默认为 |
|
所需JVM的安装目录 |
|
日志存放目录, 默认 |
|
数据存放目录,默认 |
|
配置文件存放目录 (包括 |
|
可能需要应用的任何其他JVM系统属性。 |
|
服务启动方式, |
|
procrun等待服务正常退出的超时时间。默认为 |
elasticsearch-service.bat
依赖 Apache Commons Daemon 去安装服务. 先前为安装服务设置的环境变量将被复制,以在服务运行期间被使用. 也就是说,服务安装之后,对环境变量所做的修改将不会生效,除非重装服务。
在Windows上,当从命令行运行ES时,或者首次将ES作为服务安装时,可以将堆大小配置为任何其他Elasticsearch安装。此处不明白什么意思,原文:
On Windows, the heap size can be configured as for any other Elasticsearch installation when running Elasticsearch from the command line, or when installing Elasticsearch as a service for the first time.
要调整已安装服务的堆大小,请使用服务管理器: binelasticsearch-service.bat manager 。
使用Manager GUI
也可以使用manager GUI (elasticsearch-service-mgr.exe
)在安装了服务之后,进行一系列配置。 Manager GUI可以观察已安装的服务,包括服务状态,启动类型,JVM,启动和停止等。可以使用
elasticsearch-service.bat manager 从命令行启动manager GUI。
通过manager GUI进行的大多数更改(如JVM设置)将需要重新启动服务才能生效。
ES的目录结构
下载的.zip
包是完全独立的。解压后,默认情况下,所有文件和目录都包含在%ES_HOME%中。
这是非常方便的,因为使用ES不必创建任何目录,并且卸载ES与删除目录一样简单%ES_HOME%目录
。但是,建议更改config目录,数据目录和logs目录的默认位置,以便以后不会误删重要数据。
Type | Description | Default Location | Setting |
home | ES的根目录或%ES_HOME% | zip解压的位置 | |
bin | 二进制脚本,包括elasticsearch(启动一个节点),elasticsearch-plugin(安装插件) | %ES_HOME%in | |
conf | 配置文件,包括elasticsearch.yml | %ES_HOME%config | path.conf |
data | 在节点上分配的每个索引/分片的数据文件的存放位置。可以支持多个位置。 | %ES_HOME%data | path.data |
logs | 日志文件位置 | %ES_HOME%logs | path.logs |
plugins | 插件文件位置。每个插件都将包含在一个子目录中。 | %ES_HOME%plugins | |
repo |
Shared file system repository locations.Can hold multiple locations. A file system repository can be placed in to any subdirectory of any directory specified here. (没看懂,直接上原文) |
Not configured | path.repo |
script | 脚本文件的位置 | %ES_HOME%scripts | path.scripts |
下一步
已经安装了ES的测试环境,在进行开发或者用在生成环境之前,还需要做一些配置:
- 了解如何配置ES
- 配置重要的ES设置
- 配置重要的系统设置