使用 Debian 包安装 Elasticsearch

Elasticsearch 的 Debian 包可以从我们的网站或者从我们的 APT 仓库下载。它可以用于在任何基于 Debian 的系统（如 Debian 和 Ubuntu）上安装 Elasticsearch。

这个包包含免费和订阅的特性。开始 30 天的试用，尝试所有功能。

Elasticsearch 的最新稳定版本，能在 Elasticsearch 下载页面找到。其他版本能在历史发布页面找到。

?> Elasticsearch 包含 JDK 维护者（GPLv2+CE）提供的 OpenJDK 捆绑版本。要使用自己的 Java 版本，查阅 JVM 版本要求。

导入 Elasticsearch PGP 密钥

我们使用带指纹的 Elasticsearch 签名密钥（PGP 密钥 D88E42B4，存在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-7.x.list:

echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.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/7.x/apt/ ...
检查 /etc/apt/sources.list.d/elasticsearch-7.x.list 的重复条目，或者在 /etc/apt/sources.list.d/ 中的文件和 /etc/apt/sources.list 文件中定位重复条目。

?> 在基于 systemd 的发行版上，安装脚本尝试设置内核参数（如，vm.max_map_count）；你可以通过屏蔽 systemd-sysctl.service 单位来跳过这个操作。

手工下载和安装 Debian 包

Elasticsearch v7.11.1 的 Debian 包，可以按以下命令从网站下载和安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.1-amd64.deb
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.1-amd64.deb.sha512
shasum -a 512 -c elasticsearch-7.11.1-amd64.deb.sha512
sudo dpkg -i elasticsearch-7.11.1-amd64.deb

• shasum -a 512 -c 比较下载的 Debian 包 SHA 值和公开的校验值。正常应该输出 elasticsearch-{version}-amd64.deb: OK。

启用系统索引自动创建 [X-Pack]

一些商业特性会在 Elasticsearch 中自动创建索引。默认情况下， Elasticsearch 配置为允许自动创建索引而不需要额外的步骤。然而，如果你在 Elasticsearch 中禁用了自动索引创建，则必须在 elasticsearch.yml 中配置 action.auto_create_index 以允许商业特性创建以下索引：

action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*

!> 如果你在使用 Logstash 或 Beats，那么你很可能需要在你的 action.auto_create_index 设置中使用额外的索引名字，具体的值取决于你的本地配置。如果你不确定你环境的正确值，可以考虑设置这个值为*以允许自动创建所有索引。

SysV init 对 systemd

Elasticsearch 在安装后不会自动启动。如何启动和停止 Elasticsearch，取决于你的系统用的 SysV init 还是 systemd（更新的发行版用的）。你可以通过以下命令来判断用的哪个：

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 由于任何原因启动失败，它会输出失败原因到标准输出（STDOUT）。日志文件可以在 /var/log/elasticsearch/ 中被找到。

使用 systemd 运行 Elasticsearch

为了配置 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 环境变量向密码库提供密码。本地文件存在时，应该受到保护，一旦 Elasticsearch 启动并运行，就可以安全删除此文件。

echo "keystore_password" > /path/to/my_pwd_file.tmp
chmod 600 /path/to/my_pwd_file.tmp
sudo systemctl set-environment ES_KEYSTORE_PASSPHRASE_FILE=/path/to/my_pwd_file.tmp
sudo systemctl start elasticsearch.service

默认情况下，Elasticsearch 服务不会在 systemd 日志中记录信息。要启用 journalctl 日志，必须从文件 elasticsearch.service 中的 ExecStart 命令行移除 --quiet 选项。

当 systemd 日志启用时，使用 journalctl 命令日志信息可用。

要跟踪日志：

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 获取更多的命令行选项。

检查 Elasticsearch 是否正在运行

你可以通过向 localhost 的 9200 端口发送 HTTP 请求来测试 Elasticsearch 节点是否正在运行：

GET /

这会给你这样的响应：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "7.11.1",
    "build_flavor" : "default",
    "build_type" : "tar",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "8.7.0",
    "minimum_wire_compatibility_version" : "1.2.3",
    "minimum_index_compatibility_version" : "1.2.3"
  },
  "tagline" : "You Know, for Search"
}

配置 Elasticsearch

/etc/elasticsearch 目录包含 Elasticsearch 默认运行时配置。该目录和所包含的所有文件所有权在包安装时设置为 root:elasticsearch。

setgid 标志对目录 /etc/elasticsearch 应用组权限，以确保 Elasticsearch 能读取任何包含的文件和子目录。所有文件和子目录继承 root:elasticsearch 所有权。从该目录或者任何子目录运行命令，如 elasticsearch-keystore 工具，需要 root:elasticsearch 权限。

Elasticsearch 默认从 /etc/elasticsearch/elasticsearch.yml 文件加载它的配置。在配置 Elasticsearch 中解释了配置文件的格式。

Debian 包也有一个系统配置文件（/etc/default/elasticsearch），它允许你设置以下的变量：

?> 使用 systemd 的发行版本要求需要通过 systemd 配置系统资源限制，而不是通过 /etc/sysconfig/elasticsearch 文件。更多信息，请参阅 Systemd 配置。

Debian 包目录结构

Debian 包将配置文件、日志和数据目录放在基于 Debian 系统的适当位置：

下一步

你现在有一个测试 Elasticsearch 环境部署好。在你使用 Elasticsearch 正式开始开发或者生产之前，你必须做一些额外的设置：

• 学习如何配置 Elasticsearch。
• 配置重要的 Elasticsearch 设置。
• 配置重要的系统设置。

原文链接