本文只介紹在windows上的安裝和配置,其他安裝和配置請參見官方文檔 ES在windows上安裝需下載zip安裝包,解壓後bin目錄下有個 elasticsearch-service.bat 文件。運行此文件ES就會啟動服務。 ES的最新穩定版可以從這裡下載,其他版本可以從這裡找到。 Elasti ...
本文只介紹在windows上的安裝和配置,其他安裝和配置請參見官方文檔
ES在windows上安裝需下載zip安裝包,解壓後bin目錄下有個 elasticsearch-service.bat 文件。運行此文件ES就會啟動服務。
Elasticsearch需要Java 8或更高版本。
具體安裝請參見Elasticsearch和Kibana安裝
在命令行中配置ES
約定:以後我們把解壓後的目錄存放地址稱作 %ES_HOME% ,比如 D:\ProgramFiles\elasticsearch-5.4.1
ES預設從 %ES_HOME%\config\elasticsearch.yml 文件載入配置。具體配置請參考 Configuring Elasticsearch.
只要能在配置文件中指定的配置,在命令行中也能實現。像下麵這樣使用 -E 語法:
.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1
包含空格的值必須用引號括起來,比如 -Epath.logs="C:\My Logs\logs"。
通常,集群範圍內的設置(如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.1\bin>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:\ProgramFiles\elasticsearch-5.4.1\bin>elasticsearch-service install Installing service : "elasticsearch-service-x64" Using JAVA_HOME (64-bit): "D:\ProgramFiles\Java\jdk1.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.
要調整已安裝服務的堆大小,請使用服務管理器: bin\elasticsearch-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%\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 |
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設置
- 配置重要的系統設置
官方文檔:https://www.elastic.co/guide/en/elasticsearch/reference/current/windows.html