Windows 環境下安裝ES · Elasticsearch 5.4 中文文檔

# Windows 環境下安裝ES 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/windows.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/windows.html) 譯文鏈接 : [http://apache.wiki/pages/editpage.action?pageId=4882732](http://apache.wiki/pages/editpage.action?pageId=4882732) 貢獻者 : @漫步 ## Windows 環境下安裝ES Elasticsearch可以在Windows中使用安裝`.zip`包。這配備了一個`elasticsearch-service.bat`命令，它會安裝Elasticsearch來作為服務運行。 Elasticsearch的最新穩定版本可以在上找到?[下載Elasticsearch](https://www.elastic.co/downloads/elasticsearch)頁面。其它版本可以在上找到?[過去的版本頁面](https://www.elastic.co/downloads/past-releases)。 ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) Elasticsearch需要Java 8或更高版本。使用?[Oracle官方分發](http://www.oracle.com/technetwork/java/javase/downloads/index.html)?或作為開放源代碼的分布的[OpenJDK](http://openjdk.java.net/)。 ## 下載并安裝`.zip`包下載`.zip`的Elasticsearch V5.0.1檔案來源：[https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.1.zip](https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.1.zip) 你最喜歡的解壓縮工具解壓。這將創建一個文件夾叫?`elasticsearch-5.0.1`，我們稱其為 `%ES_HOME%`。在終端窗口，`cd``%ES_HOME%`目錄，例如： ``` cd C：\ elasticsearch-5.0.1 ``` ## 在命令行中運行Elasticsearch Elasticsearch可以從命令行啟動，如下所示： ``` .\bin\elasticsearch ``` 默認情況下，Elasticsearch在前臺運行，打印其日志`STDOUT`，并可以按停止`Ctrl-C`。 ## 在命令行配置Elasticsearch Elasticsearch加載從它的配置`%ES_HOME%/config/elasticsearch.yml`?默認文件。這個配置文件的格式說明[_配置Elasticsearch_](https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html "配置Elasticsearch")。可以在配置文件中指定的任何設置，也可以在命令行上指定，使用`-E`的語法如下： ``` ./bin/elasticsearch -Ecluster.name=my_cluster -Enode.name=node_1 ``` ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 包含空格的值必須用引號括起來。例如`-Epath.logs="C:\My Logs\logs"`。 ![小費](https://img.kancloud.cn/de/e3/dee3f82dc73d84dc4c0ec544b7f0dda7_66x58.jpg) 通常情況下，任何集群范圍的設置（例如`[cluster.name](http://cluster.name)`）應該被加入到`elasticsearch.yml`配置文件，而任何特定于節點的設置，例如`[node.name](http://node.name)`可以在命令行上被指定。 ## 檢查Elasticsearch運行您可以測試你的Elasticsearch節點通過發送一個HTTP請求到端口上運行`9200`的`localhost`： ``` GET / ``` 返回值，如下: ``` { "name" : "Cp8oag6", "cluster_name" : "elasticsearch", "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA", "version" : { "number" : "5.0.1", "build_hash" : "f27399d", "build_date" : "2016-03-30T09:51:41.449Z", "build_snapshot" : false, "lucene_version" : "6.2.1" }, "tagline" : "You Know, for Search" } ``` ### 安裝Elasticsearch作為Windows服務 Elasticsearch可以作為服務安裝在后臺運行，或在啟動時自動啟動，無需任何用戶交互。這可以通過實現`elasticsearch-service.bat`的腳本`bin\`，使人們安裝，刪除，管理或配置服務和潛在的啟動和停止服務文件夾中，全部由命令行。 ``` c:\elasticsearch-5.0.1\bin>elasticsearch-service Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID] ``` 該腳本需要一個參數（要執行的命令），后跟一個可選一表示服務ID（用于安裝多個Elasticsearch服務時）。可用的命令如下： | `install` | 安裝Elasticsearch作為服務 | | `remove` | 刪除已安裝的Elasticsearch服務（并停止該服務，如果啟動） | | `start` | 啟動Elasticsearch服務（如果安裝） | | `stop` | 停止Elasticsearch服務（如果已啟動） | | `manager` | 啟動GUI管理安裝服務 | 根據現有的JDK / JRE（通過設置的體系結構`JAVA_HOME`），相應的64位（x64）或32位（x86）的服務將被安裝。此信息是安裝過程中提供： ``` c:\elasticsearch-5.0.1\bin>elasticsearch-service install Installing service : "elasticsearch-service-x64" Using JAVA_HOME (64-bit): "c:\jvm\jdk1.8" The service 'elasticsearch-service-x64' has been installed. ``` ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 該服務安裝程序要求線程堆棧大小設置在jvm.options進行配置**之前**安裝的服務。在32位的Windows，你應該添加`-Xss320k`到jvm.options文件，并在64位Windows您應該添加`-Xss1m`到jvm.options文件。 ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 而JRE可用于Elasticsearch服務，由于其使用的客戶機虛擬機（而不是服務器JVM這對于長期運行的應用提供了更好的性能）其使用不鼓勵和一個將發出警告。 ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 升級（或降級）的JVM版本不需要重新安裝服務。但是，跨JVM升級類型（如JRE與SE）是不支持，而且確實需要的服務，重新安裝。 ### 設置定制服務該Elasticsearch服務可以在安裝之前通過設置以下環境變量（可以使用配置[set命令](https://technet.microsoft.com/en-us/library/cc754250(v=ws.10).aspx)在命令行，或通過`System Properties->Environment Variables`GUI）。 | `SERVICE_ID` | 的唯一標識符的服務。有用的，如果同一計算機上安裝多個實例。默認為`elasticsearch-service-x86`（在32位Windows）或`elasticsearch-service-x64`（在64位Windows）。 | | `SERVICE_USERNAME` | 用戶身份運行，默認為本地系統帳戶。 | | `SERVICE_PASSWORD` | 的密碼中指定的用戶`%SERVICE_USERNAME%`。 | | `SERVICE_DISPLAY_NAME` | 該服務的名稱。默認為`Elasticsearch <version> %SERVICE_ID%`。 | | `SERVICE_DESCRIPTION` | 該服務的描述。默認為`Elasticsearch <version> Windows Service - [https://elastic.co](https://elastic.co)`。 | | `JAVA_HOME` | 所需的JVM的安裝目錄下運行該服務。 | | `LOG_DIR` | 日志目錄，默認為`%ES_HOME%\logs`。 | | `DATA_DIR` | Data目錄，默認為`%ES_HOME%\data`。 | | `CONF_DIR` | 配置文件目錄（其中必須包括`elasticsearch.yml`?和`log4j2.properties`文件），默認為`%ES_HOME%\conf`。 | | `ES_JAVA_OPTS` | 任何額外的JVM系統屬性，你可能要應用。 | | `ES_START_TYPE` | 啟動模式的服務。可以是`auto`或者`manual`（默認）。 | | `ES_STOP_TIMEOUT` | 以秒procrun服務等待超時正常退出。默認為`0`。 | ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 在其核心，`elasticsearch-service.bat`依賴于[Apache的百科全書守護](http://commons.apache.org/proper/commons-daemon/)工程安裝服務。該服務在安裝之前設置環境變量被復制，并會在服務生命周期中使用。這意味著在安裝后對他們所做的任何更改將不被拾起，除非該服務被重新安裝。 ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 在Windows中，[堆大小](https://www.elastic.co/guide/en/elasticsearch/reference/current/heap-size.html "通過jvm.options設置JVM堆大小")可以被配置為用于從所述命令行運行Elasticsearch時，或安裝Elasticsearch作為首次一個服務時的任何其他Elasticsearch安裝。要調整堆大小已安裝的服務，使用服務管理器：`bin\elasticsearch-service.bat manager`。使用管理器GUI也可以配置服務，它已經使用管理GUI（安裝后elasticsearch-service-mgr.exe），它提供了洞察安裝的服務，包括其狀態，啟動類型，JVM啟動和停止除其他事項外設置。簡單地調用elasticsearch-service.bat manager在命令行會打開管理器窗口： ![](/download/attachments/4882732/image2016-11-25%2015%3A33%3A2.png?version=1&modificationDate=1480059182000&api=v2) 通過管理程序的GUI做的大多數更改（如JVM設置），將要求服務重新啟動才能生效。 ### 目錄結構`.zip` 分析該`.zip`包是完全獨立的。所有的文件和目錄，默認情況下，包含在`%ES_HOME%`?-解壓縮存檔時創建的目錄。這是非常方便，因為你沒有創建任何目錄開始使用Elasticsearch和卸載Elasticsearch是去掉了容易`%ES_HOME%`目錄。不過，最好是改變config目錄，數據目錄和日志目錄的默認位置，這樣你就不會刪除以后重要的數據。 | 類型 | 描述 | 默認位置 | 設置 | | --- | --- | --- | --- | | **home ** | Elasticsearch主目錄或?`%ES_HOME%` | 目錄由解包歸檔創建 | ? | | **bin ** | 二進制腳本包括`elasticsearch`啟動一個節點，并`elasticsearch-plugin`安裝插件 | `%ES_HOME%\bin` | ? | | **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 ** | 共享文件系統存儲庫位置。可以容納多個位置。文件系統存儲庫可以放在這里指定的任意目錄中的任何子目錄。 | 未配置 | `path.repo` | | **script ** | 腳本文件位置。 | `%ES_HOME%\scripts` | `path.scripts` | ## 下一步現在，您有一個測試環境Elasticsearch成立。開始之前嚴重的發展或進入生產與Elasticsearch，你需要做一些額外的設置： * 了解如何[配置Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html "配置Elasticsearch")。 * 配置[重要Elasticsearch設置](https://www.elastic.co/guide/en/elasticsearch/reference/current/important-settings.html "重要Elasticsearch配置")。 * 配置[重要的系統設置](https://www.elastic.co/guide/en/elasticsearch/reference/current/system-config.html "重要的系統配置")。