Debian軟件包安裝方式 · my-elasticsearch-cn

# Debian軟件包安裝方式 Elasticsearch的Debian軟件包可以從[我們的網站下載](#install-deb)或從[我們的APT倉庫](#deb-repo)安裝。它可以用于任何基于Debian的系統上安裝Elasticsearch，如Debian和Ubuntu。 Elasticsearch的最新穩定版本可以在[Elasticsearch下載](https://www.elastic.co/downloads/elasticsearch)頁面獲取。其它版本可以在上[之前的下載頁面](https://www.elastic.co/downloads/past-releases)找到。 > 注意 > > Elasticsearch需要Java 8或更高版本。可以使用[Oracle官方發布](http://www.oracle.com/technetwork/java/javase/downloads/index.html)或開源版本的[OpenJDK](http://openjdk.java.net/)。 ## 導入Elasticsearch PGP Key Elasticsearch的所有包都采用如下指紋與簽名Key進行簽名（PGP key [D88E42B4](https://pgp.mit.edu/pks/lookup?op=vindex&search=0xD27D666CD88E42B4)，可從[https://pgp.mit.edu](https://pgp.mit.edu/)）： ``` 4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4 ``` 下載并安裝該公用簽名密鑰： ``` wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add - ``` ## 從APT庫中安裝在操作之前您可能需要在Debian系統中安裝`apt-transport-https`軟件包： ``` sudo apt-get install apt-transport-https ``` 庫定義保存到`/etc/apt/sources.list.d/elastic-5.x.list`： ``` echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list ``` > 注意 > > 有以下幾個原因不使用`add-apt-repository`： > > 1. `add-apt-repository`添加到系統`/etc/apt/sources.list`文件，而不是在`/etc/apt/sources.list.d`中清空之前的倉庫文件 > 2. `add-apt-repository`需要按照一些非默認的依賴以及在許多發行版本中他不是默認安裝的。 > 3. 老版本的`add-apt-repository`總是添加`deb-src`將導致錯誤，因為我們不提供源碼包。如果你添加了`deb-src`，你將會看到一個如下的錯誤直到你刪除了`deb-src`： > ``` > Unable to find expected entry 'main/source/Sources' in Release file > (Wrong sources.list entry or malformed file) > > ``` 您可以通過如下方式安裝Elasticsearch Debian軟件包： ``` sudo apt-get update && sudo apt-get install elasticsearch ``` > 警告 > > 如果同一Elasticsearch版本庫中兩個條目，在使用`apt-get update`是你會看到在這樣的錯誤： > > > ``` > Duplicate sources.list entry https://artifacts.elastic.co/packages/6.x/apt/ ... > > ``` > 在`/etc/apt/sources.list.d`和`/和/etc/apt/sources.list`文件中檢查下重復的`/etc/apt/sources.list.d/elasticsearch-6.x.list`條目。 > > 注意 > > 在`systemd-based`的發行中，安裝腳本會嘗試設置內核參數（例如：`vm.max_map_count`）；你可以通過設置環境變量`ES_SKIP_SET_KERNEL_PARAMETERS=true`跳過此設置。 ## 手動下載并安裝Debian軟件包 ``` wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.0.0.deb wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.0.0.deb.sha512 shasum -a 512 -c elasticsearch-6.0.0.deb.sha512 ① sudo dpkg -i elasticsearch-6.0.0.deb ``` ① 通過`sha1sum`或`shasum`比較官方發布的[SHA公鑰](https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.3.0.deb.sha1) ## `SysV init` vs `systemd` Elasticsearch不是在安裝后自動啟動。如何啟動和停止Elasticsearch取決于你的系統是否使用的`SysV init`或`system`（較新發行版中使用）。你可以說這是一個用來運行以下命令： ``` ps -p 1 ``` ## 通過`SysV init`啟動Elasticsearch 使用`update-rc.d`命令來配置Elasticsearch在系統啟動時自動啟動: ``` sudo update-rc.d elasticsearch defaults 95 10 ``` Elasticsearch可以通過`service`命令來啟動與停止： ``` sudo -i service elasticsearch start sudo -i service elasticsearch stop ``` 任何原因的Elasticsearch啟動失敗，都會將原因打印到控制套。日志文件可以在`/var/log/elasticsearch/`中找到。 ## 通過`systemd`啟動Elasticsearch 要配置Elasticsearch在系統啟動時自動啟動，運行以下命令： ``` sudo /bin/systemctl daemon-reload sudo /bin/systemctl enable elasticsearch.service ``` Elasticsearch可以通過service命令來啟動與停止： ``` sudo systemctl start elasticsearch.service sudo systemctl stop elasticsearch.service ``` 無論Elasticsearch是否成功沒有啟動, 這些命令不提供反饋。相反，該信息將被寫入位于`/var/log/elasticsearch/`的日志文件中。默認情況下，Elasticsearch服務的信息不記錄在信息`systemd` 的`journal`日志中。若要啟用`journalctl`日志記錄，在`elasticsearch.service`文件的`ExecStart`命令行中必須刪除`--quiet`選項。當`systemd`啟用了日志記錄，日志信息的使用可用`journalctl`命令： `tail`查看`journal`: ``` sudo journalctl -f ``` 要列出`journal`中elasticsearch服務的日志條目： ``` sudo journalctl --unit elasticsearch ``` 要列出指定時間之后的列出`journal`中elasticsearch服務的日志條目： ``` sudo journalctl --unit elasticsearch --since "2016-10-30 18:17:16" ``` 更多的`journalctl`操作手冊，請參考：<https://www.freedesktop.org/software/systemd/man/journalctl.html>。 ## 檢查Elasticsearch運行您可以在已運行的Elasticsearch節點上，發送一個HTTP請求測試`localhost`的`9200`端口： ``` GET / ``` 返回的消息應該是這樣的： ``` { "name" : "Cp8oag6", "cluster_name" : "elasticsearch", "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA", "version" : { "number" : "6.0.0", "build_hash" : "f27399d", "build_date" : "2016-03-30T09:51:41.449Z", "build_snapshot" : false, "lucene_version" : "7.0.1", "minimum_wire_compatibility_version" : "1.2.3", "minimum_index_compatibility_version" : "1.2.3" }, "tagline" : "You Know, for Search" } ``` ## 配置Elasticsearch Elasticsearch默認從`/etc/elasticsearch/elasticsearch.yml`文件中加載配置。這個配置文件的格式說明請參考[Elasticsearch配置](../Configuring_Elasticsearch.md)。 Debian軟件包也有一個系統配置文件（/etc/default/elasticsearch），它允許你設置以下參數： * JAVA\_HOME自定義java路徑。 * MAX\_OPEN\_FILES最大的打開文件數，默認最大數量`65536`。MAX\_LOCKED\_MEMORY最大鎖定內存大小。你使用`bootstrap.memory_lock`的`elasticsearch.yml`選項將被設置為`unlimited`。 * MAX\_MAP\_COUNT進程的內存映射區域最大數量。如果你使用`mmapfs`的索引存儲類型，確保此項設置為高值。欲了解更多信息，請查看[Linux內核文件](https://github.com/torvalds/linux/blob/master/Documentation/sysctl/vm.txt)查看相關的`max_map_count`。這是在啟動elasticsearch之前通過`sysctl`設置的，默認為262144。 * ES_PATH_CONF配置文件目錄（其中必須包括`elasticsearch.yml`和`log4j2.properties`文件），默認為`/etc/elasticsearch`。 * ES\_JAVA\_OPTS任何額外的JVM系統屬性，你可能要應用。RESTART\_ON\_UPGRADE配置在安裝包升級后重啟，默認為`false`。這意味著你將在安裝包后需要手動重新啟動您的elasticsearch實例。這樣做的原因是為了保證，在群集升級時不會連續的重新分配分片導致高網絡流量、并降低群集的響應時間。 > 注意 > > 使用systemd部署需要配置`systemd`的系統資源限制，而不是通過`/etc/sysconfig/elasticsearch`文件。更多信息請參見：[系統設置](../Important_System_Configuration/Configuring_system_settings.md#systemd)。 ## Debian目錄結構 Debian包中配置文件、日志和數據目錄在Debian-based系統中對應的位置: * home Elasticsearch主目錄或 $ES\_HOME/usr/share/elasticsearch * bin 二進制腳本，包括啟動節點的`elasticsearch`、安裝插件的`elasticsearch-plugin`/usr/share/elasticsearch/bin * conf 配置文件，包括`elasticsearch.yml`/etc/elasticsearchpath.conf * conf 環境變量，包括heap大小、文件操作符/etc/default/elasticsearch * data 節點上分配的各索引/分片的數據文件的目錄，可以配置多個位置。/var/lib/elasticsearchpath.data * logs 日志文件的位置。/var/log/elasticsearchpath.logs * plugins 插件的位置。每一個插件將被包含在一個子目錄。/usr/share/elasticsearch/plugins * repo 共享文件系統存儲庫位置。可以容納多個位置。文件系統存儲庫可以放在這里指定的任意目錄中的任何子目錄。未配置path.repo * scrip t腳本文件位置。/etc/elasticsearch/scriptspath.scripts ## 下一步現在，您搭建了一個測試環境Elasticsearch。開始更深入的研究或投入生產使用Elasticsearch之前，你需要做一些額外的配置： - 了解如何[配置Elasticsearch](../Configuring_Elasticsearch.md)。 - 配置[重要的Elasticsearch設置](../Important_Elasticsearch_configuration.md)。 - 配置[重要的系統設置](../Important_System_Configuration.md)。