使用 RPM 安装 Elasticsearch

我们使用 Elasticsearch 签名密钥（PGP 密钥 D88E42B4，可从 https://pgp.mit.edu 获取）对我们所有的软件包进行签名，指纹为

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

下载并安装公共签名密钥

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

在基于 RedHat 的发行版的 /etc/yum.repos.d/ 目录中创建一个名为 elasticsearch.repo 的文件，或者在基于 OpenSuSE 的发行版的 /etc/zypp/repos.d/ 目录中创建一个名为 elasticsearch.repo 的文件，其中包含

[elasticsearch]
name=Elasticsearch repository for 8.x packages
baseurl=https://artifacts.elastic.co/packages/8.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md

您的存储库已准备好使用。您现在可以使用以下命令之一安装 Elasticsearch

sudo yum install --enablerepo=elasticsearch elasticsearch 
sudo dnf install --enablerepo=elasticsearch elasticsearch 
sudo zypper modifyrepo --enable elasticsearch && \
  sudo zypper install elasticsearch; \
  sudo zypper modifyrepo --disable elasticsearch 

Elasticsearch v8.17.0 的 RPM 可以从网站下载并按如下方式安装

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.0-x86_64.rpm
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.17.0-x86_64.rpm.sha512
shasum -a 512 -c elasticsearch-8.17.0-x86_64.rpm.sha512 
sudo rpm --install elasticsearch-8.17.0-x86_64.rpm

要配置 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 环境变量向 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。

[2022-01-31T01:22:31,077][INFO ][o.e.n.Node               ] [instance-0000000123] starting ...
...
[2022-01-31T01:37:15,077][INFO ][o.e.n.Node               ] [instance-0000000123] stopping ...

Jan 31 01:22:30 debian systemd[1]: Starting Elasticsearch...
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Start operation timed out. Terminating.
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Main process exited, code=killed, status=15/TERM
Jan 31 01:37:15 debian systemd[1]: elasticsearch.service: Failed with result 'timeout'.
Jan 31 01:37:15 debian systemd[1]: Failed to start Elasticsearch.

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

curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic:$ELASTIC_PASSWORD https://127.0.0.1:9200 

该调用返回如下响应

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

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

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

默认情况下，Elasticsearch 从 /etc/elasticsearch/elasticsearch.yml 文件加载其配置。在配置 Elasticsearch中解释了此配置文件的格式。

RPM 还有一个系统配置文件 (/etc/sysconfig/elasticsearch)，您可以使用该文件设置以下参数

当您首次启动 Elasticsearch 时，会自动为 HTTP 层配置 TLS。会在磁盘上的以下位置生成并存储 CA 证书

/etc/elasticsearch/certs/http_ca.crt

此证书的十六进制编码 SHA-256 指纹也会输出到终端。任何连接到 Elasticsearch 的客户端，例如Elasticsearch 客户端、Beats、独立的 Elastic Agent 和 Logstash，都必须验证它们信任 Elasticsearch 用于 HTTPS 的证书。Fleet Server 和 Fleet 管理的 Elastic Agent 会自动配置为信任 CA 证书。其他客户端可以通过使用 CA 证书的指纹或 CA 证书本身来建立信任。

如果自动配置过程已经完成，您仍然可以获取安全证书的指纹。您也可以将 CA 证书复制到您的计算机，并配置您的客户端以使用它。

复制 Elasticsearch 启动时输出到终端的指纹值，并配置您的客户端以使用此指纹在连接到 Elasticsearch 时建立信任。

如果自动配置过程已经完成，您仍然可以通过运行以下命令获取安全证书的指纹。路径指向 HTTP 层的自动生成 CA 证书。

openssl x509 -fingerprint -sha256 -in config/certs/http_ca.crt

该命令返回安全证书，包括指纹。 issuer 应该是 Elasticsearch security auto-configuration HTTP CA。

issuer= /CN=Elasticsearch security auto-configuration HTTP CA
SHA256 Fingerprint=<fingerprint>

如果您的库不支持验证指纹的方法，则会在每个 Elasticsearch 节点上的以下目录中创建自动生成的 CA 证书

/etc/elasticsearch/certs/http_ca.crt

将 http_ca.crt 文件复制到您的计算机，并配置您的客户端以使用此证书在连接到 Elasticsearch 时建立信任。

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

bin/elasticsearch-keystore show xpack.security.http.ssl.keystore.secure_password

bin/elasticsearch-keystore show xpack.security.transport.ssl.keystore.secure_password