ubuntu 安裝Elasticsearch5.0（Debian包）

經過Debian包安裝Elasticsearch

Elasticsearch的Debian包能夠從downloaded from our website或APT repository
它能夠用於在任何Debian-based的系統（如Debian和Ubuntu）上安裝Elasticsearch。
Elasticsearch的最新穩定版在Download Elasticsearch下載，其餘的版本在Past Releases page下載。

---

NOTE:

Elasticsearch須要java8或者更高的java版本。
可使用official Oracle distribution 或者使用open-source distribution 例如OpenJDK。

---

1.導入Elasticsearch PGP Key

咱們利用以下指紋簽名的密鑰簽署驗證了全部的包

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下載並安裝公共簽名密鑰：

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

2.從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

---

WARNING:

不要使用add-apt-repository，由於它將添加一個deb-src條目，但咱們不提供源包。 若是你已添加deb-src條目，你將看到相似以下的錯誤：

Unable to find expected entry 'main/source/Sources' in Release file
(Wrong sources.list entry or malformed file)

從/etc/apt/sources.list文件中刪除deb-src條目，安裝能夠正常工做

---

你能夠經過以下命令安裝Elasticsearch Debian軟件包：

sudo apt-get update && sudo apt-get install elasticsearch

---

WARNING:

若是同一Elasticsearch存儲庫存在兩個條目，則在apt-get update期間將出現相似如下錯誤：

Duplicate sources.list entry 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中尋找重複的條目

---

---

NOTE:

在systemd-based的版本，安裝腳本將嘗試設置內核參數（例如，vm.max_map_count）; 你能夠經過將環境變量ES_SKIP_SET_KERNEL_PARAMETERS設置爲true來跳過此操做。

---

3.下載並手動安裝debian軟件包

用於Elasticsearch v5.0.2的Debian軟件包能夠從網站下載並安裝以下：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.0.2.deb
sha1sum elasticsearch-5.0.2.deb 
sudo dpkg -i elasticsearch-5.0.2.deb

4.Sysv init vs systemd

Elasticsearch在安裝後不會自動啓動。 如何啓動和中止Elasticsearch取決於你的系統是使用SysV init仍是systemd（由較新的發行版使用）。
你能夠經過運行此命令來肯定：

ps -p 1

5.Running Elasticsearch with Sysv init

使用update-rc.d命令將Elasticsearch配置爲在系統啓動時自動啓動：

sudo update-rc.d elasticsearch defaults 95 10

可使用service命令啓動和中止Elasticsearch：

sudo -i service elasticsearch start
sudo -i service elasticsearch stop

若是Elasticsearch因爲任何緣由沒法啓動，它會將失敗的緣由打印到STDOUT。 日誌文件能夠在/var/log/elasticsearch/中找到。

6.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/中的日誌文件中。
（你能夠嘗試 sudo systemctl status elasticsearch.service）

默認狀況下，Elasticsearch服務不會被記錄到systemd journal。 要啓用journalctl，必須從elasticsearch.service文件中的ExecStart命令行中刪除--quiet選項。

當啓用systemd日誌記錄時，使用journalctl命令能夠得到日誌記錄信息：

To tail the journal:

sudo journalctl -f

To list journal entries for the elasticsearch service:

sudo journalctl --unit elasticsearch

To list journal entries for the elasticsearch service starting from a given time:

sudo journalctl --unit elasticsearch --since  "2016-10-30 18:17:16"

有關更多命令行選項，請檢查man journalctl或https://www.freedesktop.org/software/systemd/man/journalctl.html。

7.檢查elasticsearch是否在運行

你能夠經過向localhost上的端口9200發送HTTP請求來測試Elasticsearch節點是否正在運行：

GET /

若是elasticsearch正在運行，你會獲得以下response

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "5.0.2",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "6.2.1"
  },
  "tagline" : "You Know, for Search"
}

8.配置Elasticsearch

默認狀況下，Elasticsearch從/etc/elasticsearch/elasticsearch.yml文件加載其配置。
此配置文件的格式在Configuring Elasticsearch中進行了說明

Debian包還有一個系統配置文件/etc/default/elasticsearch，容許你設置如下參數：

參數	解釋
ES_USER	定義user名稱，默認爲elasticsearch
ES_GROUP	定義group名稱，默認爲elasticsearch
JAVA_HOME	設置java路徑
MAX_OPEN_FILES	最大打開文件數，默認值爲65536
MAX_LOCKED_MEMORY	最大鎖定內存大小，若是在elasticsearch.yml 設置了bootstrap.memory_lock=true，此處設置爲unlimited
MAX_MAP_COUNT	進程可能具備的內存映射區域的最大數量。 若是使用mmapfs做爲索引存儲類型，請確保將其設置爲較高的值。有關更多信息，請查看[]。 這是在啓動elasticsearch以前經過sysctl設置的。 默認爲262144。
LOG_DIR	日誌文件目錄，默認爲/var/log/elasticsearch
DATA_DIR	數據文件目錄，默認爲/var/lib/elasticsearch
CONF_DIR	配置文件目錄（須要包括elasticsearch.yml和log4j2.properties文件），默認爲/etc/elasticsearch
ES_JAVA_OPTS	想要應用的任何其餘JVM系統屬性
RESTART_ON_UPGRADE	配置軟件包升級時的從新啓動，默認爲false。 這意味着您必須在手動安裝軟件包後從新啓動elasticsearch實例。這樣作的緣由是確保集羣中的升級不會致使持續的分片從新分配，從而致使高網絡流量並減小集羣的響應時間。

---

NOTE:

使用systemd的版本須要經過systemd而不是經過/etc/sysconfig/elasticsearch文件配置系統資源限制。 有關詳細信息，請參閱。

---

9.Debian包安裝後的目錄結構

Type	Description	Default Location	Setting
home	elasticsearch主目錄($ES_HOME)	/usr/share/elasticsearch
bin	elasticsearch啓動節點啓動腳本，elasticsearch-plugin插件安裝腳本	/usr/share/elasticsearch/bin
conf	配置文件，包含elasticsearch.yml	/etc/elasticsearch	path.conf
conf	環境變量設置，包括heap size、file descriptors	/etc/default/elasticsearch
data	節點上分配的每一個index/shard的數據文件的位置,能夠有多個位置	/var/lib/elasticsearch	path.data
logs	日誌文件的存放位置	/var/log/elasticsearch	path.logs
plugins	插件文件的位置，每一個插件一個子文件夾	/usr/share/elasticsearch/plugins
repo	共享文件系統存儲庫位置,容納多個位置。能夠放置在此處指定的任何目錄的任何子目錄中。	Not configured	path.repo
script	腳本文件的位置	$ES_HOME/scripts	path.scripts

10.進一步

你如今已經設置了一個測試Elasticsearch環境。 在開始認真開發或使用Elasticsearch開始生產以前，您須要進行一些額外的設置：

• 學習如何configure Elasticsearch
• 嘗試配置important Elasticsearch settings
• 嘗試配置important system settings

---

原文地址