Elasticsearch Reference [7.2]中文文档(六)

注意:此文档为自译,由于个人能力有限,只作为个人学习文档分享。原文档请访问elastic.co

在Windows使用 `.zip` 安装 Elasticsearch 

Elasticsearch 可以使用 `.zip` 文件安装在Windows上,使用 `elasticsearch-service.bat` 命令来启动一个服务来建立一个Elasticsearch。

TIP: Elasticsearch 过去是使用 `.zip` 文件来安装到Windows上的,但是现在<<windows, MSI installer package>> 可以在Windows上给你带来最新的体验。如果你喜欢的话,你也可以继续使用 `.zip` 文件.

NOTE: 在Windows上,elasticsearch的机器学习功能,需要微软的C语言运行库支持 Microsoft Universal C Runtime library. 它已经内置在了Windows 10, Windows Server 2016 和其他最新的Windows系统上. 对于以前的Windows系统,它可以通过Windows更新来安装C Runtime library在这些系统上,或者浏览此网站[separate download]。如果你不安装 Microsoft Universal C Runtime library 你仍然可以使用elasticsearch的大部分功能,当然不包括机器学习功能 。

下载和安装`.zip`包

下载最新的稳定版Elasticsearch [Download Elasticsearch] page
https://www.elastic.co/downloads/elasticsearch
下载其他的版本 [Past Releases page]
https://www.elastic.co/downloads/past-releases
另外,你可以下载下面的软件包,它包含了在Apache 2.0许可的一些功能。https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-{version}-windows-x86_64.zip

使用你的解压工具解压.,它会创建一个名为elasticsearch-{version} 的文件夹, 通常我们也称它为 `%ES_HOME%` 。在终端窗口, 进入到 `%ES_HOME%` 目录, 比如:

cd c:\elasticsearch-{version}

使用命令行启动服务

elasticsearch可以通过下面得命令来启动服务。

.\bin\elasticsearch.bat

默认情况下,elasticsearch在后台运行,同时打印日志到STDOUT,可以通过Ctrl-C来停止。

使用命令行配置

Elasticsearch 默认是在 `%ES_HOME%\config\elasticsearch.yml` 文件中加载配置信息。这种格式的文件会在中<<settings>>详细讲解。在配置文件中所有的设置都可以在命令行中使用-E的方式设置。
.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1

NOTE: 包含地址的值必须使用引号括起来,例如 `-Epath.logs="C:\My Logs\logs"` 。

TIP: 通常,所有的集群内的设定(比如 cluster.name)应该添加到elasticsearch.yml配置文件,同时,所有的节点具体的设定比如node.name应该在命令行中被指定。

查看elasticsearch的运行

你可以通过发送HTTP请求在本地的9200端口来测试你的正在运行的elasticsearch节点。

get /

它会给你一个response,像这样:

日志打印在stdout,可以使用-q和--quite命令行选项来停止打印。

在Windows上安装一个Elasticsearch服务

Elasticsearch可在开机时,不需要任何的用户操作,自动的在后台启动一个服务。需要通过将 `elasticsearch-service.bat` 脚本放入 `bin\` 文件夹,/bin文件夹可以允许使用命令行来,安装,删除,管理或者配置一个服务和启动停止服务。

c:\elasticsearch-{version}{backslash}bin>elasticsearch-service.bat
Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]

这个脚本elasticsearch-service.bat需要一个参数(执行命名)再加上一个可选的服务ID(在众多Elasticsearch可用的服务)。

命令如下:The commands available are:

服务名称和 `JAVA_HOME` 的值都会安装的时候显示出来:

c:\elasticsearch-{version}{backslash}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.

NOTE: 当使用JRE时,由于Elasticsearch使用的是JAVA虚拟客户端,这种用法是过时的并且会出现一个警告。
NOTE: 你应该为你的服务提前将JDK的安装位置配置到系统环境的 `JAVA_HOME` 中,
如果你升级了JDK,你不需要重装这些服务,只需要将新的JDK安装位置配置到系统环境的 `JAVA_HOME` 中,然而通过JVM更新的则不行,比如JRE versus SE,还需要重新安装所有服务。

定制化服务设置

Elasticsearch可以先配置再安装,一般是通过设置以下的环境变量: (也可以使用命令行 https://technet.microsoft.com/en-us/library/cc754250(v=ws.10).aspx[set command] , 或者使用 `System Properties->Environment Variables` GUI).

NOTE: 关键 elasticsearch-service.bat是依赖 http://commons.apache.org/proper/commons-daemon/[Apache Commons Daemon] 工程来安装服务的。在服务被安装之前环境变量会被复制,并在服务的生命周期里面一直使用。这意味着任何的改变不会被已安装的服务接受,除非重装这些服务。

NOTE: 在Windows上, 在已有运行着Elasticsearch时,或者是第一次安装Elasticsaerch时, <<heap-size,heap size>> 可以配置在所有的已安装的Elasticsearch上。可以使用服务管理器 `bin\elasticsearch-service.bat manager` 在已安装的服务上调整heap size。

NOTE: 在服务运行时,服务会通过elasticsearch,自动为用户配置一个私有的、临时的目录。这个目录作为配置目录的子目录,提供给用户来运行程序。如果服务在不同的用户下运行,你可以配置要使用的服务临时目录,在你执行服务程序之前,设置环境变量中的 `ES_TMPDIR` 的首选地址。

Using the Manager GUI

安装并使用管理GUI (`elasticsearch-service-mgr.exe`),同样也可以配置服务。GUI能深入了解服务,包括了它的状态、启动方式、JVM、开始、结束和其他的一些东西。使用命令行来简便的调用 `elasticsearch-service.bat manager` ,他将会打开一个管理窗口:

多数的更改(比如JVM设置)都可以通过管理GUI设置,然后重启服务来让他生效。

 .zip文件的目录布局

`.zip` 包是完全独立的。所有的文件和目录在默认情况下都被包含在  `%ES_HOME%` ,它会在解压文件的时候自动生成。

在最初使用elasticsearch时你不必去创建任何的目录,在卸载elasticsearch时只需要简单的移除$ES_HOME 目录但是,建议改变默认的配置文件目录、数据目录、和日志目录以便你稍后不会删除重要的数据。

后续

你现在可以试着一下建立elasticsearch。在你认真开发或者把elasticsearch带入产品,你必须做一些额外的设置

学习何如配置elasticsearch

配置主要的elasticsearch设置

配置重要的系统设置




-- --
  • 投诉或建议
评论