Debian軟件包安裝Elasticsearch · Elasticsearch 5.4 中文文檔

# Debian軟件包安裝Elasticsearch 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html#deb-key](https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html#deb-key) 譯文鏈接 : [http://apache.wiki/pages/editpage.action?pageId=4882727](http://apache.wiki/pages/editpage.action?pageId=4882727) 貢獻者 : @漫步 ## Debian軟件包安裝Elasticsearch Debian的軟件包Elasticsearch可以[從我們的網站下載](https://www.elastic.co/guide/en/elasticsearch/reference/current/rpm.html#install-rpm "下載并手動安裝RPM")?或從我們的?[APT倉庫](https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html#deb-repo "從APT庫中安裝")。它可以用于任何基于Debian的系統，如Debian和Ubuntu上安裝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/)。 ## 導入Elasticsearch PGP密鑰我們簽署所有我們與Elasticsearch簽名密鑰包（PGP密鑰?[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 ：// 文物。彈性。合/ GPG - KEY - elasticsearch | sudo易于- 鍵添加- ``` ## 從APT庫中安裝您可能需要安裝`apt-transport-https`程序之前，Debian軟件包： ``` sudo易于- get安裝容易- 運輸- HTTPS ``` 庫定義保存到?`/etc/apt/sources.list.d/elastic-5.x.list`： ``` 回聲“的deb https://artifacts.elastic.co/packages/5.x/apt~~V穩定的主” | sudo的發球- 一/ 等/ 易/ 來源。名單。e / 彈性- 5.x的。名單????????????????????? ``` ![警告](https://img.kancloud.cn/c9/ac/c9ac02e31cc8df94b333d6ac63d18aa1_66x58.jpg) 不要使用`add-apt-repository`，因為它會增加一個`deb-src`條目，但是我們不提供源代碼包。如果您已經添加了`deb-src`條目，你會看到如下的錯誤： ``` 無法找到預期的條目發行文件的主要/源極/源“ （錯誤的sources.list條目或格式錯誤的文件） ``` 刪除`deb-src`從入門`/etc/apt/sources.list`文件，按預期的方式安裝應該工作。您可以通過安裝Elasticsearch Debian軟件包： ``` sudo易于- 得到更新&& 命令和apt - get安裝elasticsearch ``` ![警告](https://img.kancloud.cn/c9/ac/c9ac02e31cc8df94b333d6ac63d18aa1_66x58.jpg) 如果同一Elasticsearch版本庫中兩個條目，你會看到在這樣的錯誤`apt-get update`： ``` 重復的sources.list進入https://artifacts.elastic.co/packages/5.x/apt/ ...` ``` 檢查`/etc/apt/sources.list.d/elasticsearch-5.x.list`的重復條目，或找到文件之間的重復條目`/etc/apt/sources.list.d/`和`/etc/apt/sources.list`文件。 ## 下載并安裝Debian軟件包手動 ``` wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.1.deb sha1sum elasticsearch-5.0.1.deb sudo dpkg -i elasticsearch-5.0.1.deb ``` | [![](https://img.kancloud.cn/89/2e/892e2d6105d4361c3e81583c8e019d23_14x15.jpg)](https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html#CO3-1) | 通過比較產生的SHA?`sha1sum`或`shasum`與 ?[published SHA](https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.1.deb.sha1).。 | ### SysV?`init`?vs?`systemd` Elasticsearch是不是在安裝后自動啟動。如何啟動和停止Elasticsearch取決于你的系統是否使用的SysV`init`或?`systemd`（較新發行版中使用）。你可以說這是一個用來運行以下命令： ``` PS - p 1 ``` ### Running Elasticsearch with SysV?`init` 使用`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無法啟動以任何理由，將打印未能STDOUT的原因。日志中可以找到的文件`/var/log/elasticsearch/` ### Running Elasticsearch with?`systemd` 要配置Elasticsearch時自動啟動系統啟動，運行以下命令： ``` sudo /bin/systemctl daemon-reload sudo /bin/systemctl enable elasticsearch.service ``` Elasticsearch可以啟動和停止，如下所示: ``` sudo systemctl start elasticsearch.service sudo systemctl stop elasticsearch.service ``` 這些命令不提供反饋，Elasticsearch是否成功沒有啟動。相反，該信息將被寫入在位于在日志文件中`/var/log/elasticsearch/`。默認情況下，Elasticsearch服務不記錄在信息`systemd`?雜志。要啟用`journalctl`日志記錄，該`--quiet`選項必須從被刪除`ExecStart`的命令行`elasticsearch.service`文件。當`systemd`啟用了日志記錄，日志信息的使用可用`journalctl`的命令： tail 查看? journal: ``` sudo journalctl -f ``` 要列出elasticsearch服務日記帳分錄： ``` sudo journalctl --unit elasticsearch ``` 要列出從給定的時間啟動elasticsearch服務日記帳分錄： ``` sudo journalctl --unit elasticsearch --since "2016-10-30 18:17:16" ``` 檢查 `man journalctl`或[https://www.freedesktop.org/software/systemd/man/journalctl.html](https://www.freedesktop.org/software/systemd/man/journalctl.html)更多的命令行選項。 ## 檢查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 Elasticsearch加載從它的配置`/etc/elasticsearch/elasticsearch.yml`?默認文件。這個配置文件的格式說明?[_配置Elasticsearch_](https://www.elastic.co/guide/en/elasticsearch/reference/current/settings.html "配置Elasticsearch")。 Debian軟件包也有一個系統配置文件（`/etc/default/elasticsearch`），它允許你設置以下參數： | `ES_USER` | 用戶運行的，默認為`elasticsearch`。 | | `ES_GROUP` | 本組運行的，默認為`elasticsearch`。 | | `JAVA_HOME` | 設置定制的Java路徑中使用。 | | `MAX_OPEN_FILES` | 打開文件，默認最大數量`65536`。 | | `MAX_LOCKED_MEMORY` | 最大鎖定內存大小。設置為`unlimited`，如果你使用?`bootstrap.memory_lock`的elasticsearch.yml選項。 | | `MAX_MAP_COUNT` | 的過程中可能出現內存映射區域的最大數量。如果你使用`mmapfs`?的索引存儲類型，確保此項設置為高值。欲了解更多信息，請查看?[Linux內核文件](https://github.com/torvalds/linux/blob/master/Documentation/sysctl/vm.txt)?有關`max_map_count`。這是通過設置`sysctl`在開始之前elasticsearch。默認為`262144`。 | | `LOG_DIR` | 日志目錄，默認為`/var/log/elasticsearch`。 | | `DATA_DIR` | Data目錄，默認為`/var/lib/elasticsearch`。 | | `CONF_DIR` | 配置文件目錄（其中必須包括`elasticsearch.yml`?和`log4j2.properties`文件），默認為`/etc/elasticsearch`。 | | `ES_JAVA_OPTS` | 任何額外的JVM系統屬性，你可能要應用。 | | `RESTART_ON_UPGRADE` | 配置上的升級包，默認為重啟`false`。這意味著你將有手動安裝包后重新啟動您的elasticsearch實例。這樣做的原因是為了保證，在群集升級不會導致連續碎片重新分配導致高網絡流量并降低群集的響應時間。 | ![注意](https://img.kancloud.cn/50/1f/501f430e0c03baa87f0bbf9c0e08af0d_66x58.jpg) 使用分布`systemd`需要系統資源限制經由被配置`systemd`，而不是通過`/etc/sysconfig/elasticsearch`?文件。見[Systemd配置](https://www.elastic.co/guide/en/elasticsearch/reference/current/setting-system-settings.html#systemd "Systemd配置")以獲取更多信息。 ## Debian目錄結構 Debian的包宿的配置文件，日志，并在基于Debian的系統中相應的位置的數據目錄： | 類型 | 描述 | 默認位置 | 設置 | | --- | --- | --- | --- | | **home ** | Elasticsearch主目錄或?`$ES_HOME` | `/usr/share/elasticsearch` | ? | | **bin ** | 二進制腳本包括`elasticsearch`啟動一個節點，并`elasticsearch-plugin`安裝插件 | `/usr/share/elasticsearch/bin` | ? | | **conf ** | 配置文件，包括?`elasticsearch.yml` | `/etc/elasticsearch` | `path.conf` | | **conf ** | 環境變量，包括堆大小，文件描述符。 | `/etc/default/elasticsearch` | ? | | **data ** | 節點上分配的各索引/碎片的數據文件的位置。可以容納多個位置。 | `/var/lib/elasticsearch` | `path.data` | | **logs ** | 日志文件的位置。 | `/var/log/elasticsearch` | `path.logs` | | **plugins ** | 插件文件的位置。每一個插件將被包含在一個子目錄。 | `/usr/share/elasticsearch/plugins` | ? | | **repo ** | 共享文件系統存儲庫位置。可以容納多個位置。文件系統存儲庫可以放在這里指定的任意目錄中的任何子目錄。 | 未配置 | `path.repo` | | **script ** | 腳本文件位置。 | `/etc/elasticsearch/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 "重要的系統配置")。