Ubuntu 安装Elasticsearch5.0（Debian包）

209次阅读

共计 5776 个字符，预计需要花费 15 分钟才能阅读完成。

通过 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