本地英文版地址: ../en/rpm.html
Elasticsearch 的 RPM 安装包 可以 从我们的网站下载 或者从我们的 RPM 存储库。 它可以在任何基于 RPM 的系统上安装 Elasticsearch,比如:OpenSuSE、SLES、Centos、Red Hat 和 Oracle Enterprise 等。
老版本的 RPM 发行版,比如 SLES 11 和 CentOS 5,不支持 RPM 安装。 相关信息请阅读 在 Linux、MacOS 上从归档文件安装 Elasticsearch。
此软件包可在 Elastic 许可下免费使用。 它包含开放源码和免费的商业特性,并能访问付费商业特性。 开始为期30天的试用 尝试使用付费的商业特性。 有关 Elastic 许可等级的更多信息,请参考 订阅(Subscriptions) 页面。
Elasticsearch 最新的稳定版本可以在 下载 Elasticsearch 页面找到。 其他版本可以在 过去发布的版本(Past Releases) 页面上找到。
我们使用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/
文件夹下,
或给 基于 OpenSuSE 的发行版在 /etc/zypp/repos.d/
文件夹下,建立一个名为 elasticsearch.repo
的文件,内容如下:
[elasticsearch] name=Elasticsearch repository for 7.x packages baseurl=https://artifacts.elastic.co/packages/7.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
的可能性。
每个安装或升级命令都必须显式启用存储库,如上面的示例命令所示。
还提供了一个替代包,其中仅包含在 Apache 2.0许可证下可用的功能。要安装它,请使用以下源列表:
要安装它,请在你的elasticsearch.repo
文件中使用以下baseurl
:
baseurl=https://artifacts.elastic.co/packages/oss-7.x/yum
Elasticsearch v7.7.1 的 RPM 安装包可以从这个网站下载并安装如下:
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.7.1-x86_64.rpm wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.7.1-x86_64.rpm.sha512 shasum -a 512 -c elasticsearch-7.7.1-x86_64.rpm.sha512 sudo rpm --install elasticsearch-7.7.1-x86_64.rpm
或者,你也可以下载这个安装包,其中只包含Apache2.0许可代码:https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-oss-7.7.1-x86_64.rpm
在基于 systemd 的发行版上,安装脚本将尝试设置内核参数(例如,vm.max_map_count
);你可以通过屏蔽 systemd-sysctl.service 单元来跳过这一步。
一些商业特性会自动在 Elasticearch 中创建索引。
默认情况下,Elasticsearch 被配置为允许自动创建索引,并且不需要其他步骤。
但是,如果在 Elasticsearch 中禁用了自动索引创建,则必须在 elasticsearch.yml
文件中配置 action.auto_create_index
,以允许商业特性创建以下索引:
action.auto_create_index: .monitoring*,.watches,.triggered_watches,.watcher-history*,.ml*
Elasticsearch安装后并不会自动启动。
如何启动和停止 Elasticsearch 依赖于 你的系统使用的 SysV 是 init
还是 systemd
(较新发布的系统中使用)
通过运行以下命令,就能知道你的系统使用的是哪个:
ps -p 1
使用 chkconfig
命令配置 Elasticsearch,以便其可以在系统启动时自动启动。
sudo chkconfig --add elasticsearch
可以使用 service
命令来启动和停止 Elasticsearch :
sudo -i service elasticsearch start sudo -i service elasticsearch stop
如果 Elasticsearch 因为某些原因启动失败,会打印失败的原因到 标准输出(STDOUT)。日志记录文件在 /var/log/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 来获取更多的命令行选项。
你可以通过向 localhost
上的端口 9200
发送一个 HTTP 请求来测试 Elasticsearch 节点是否正在运行:
GET /
应该会给你一个类似下面这样的响应:
{ "name" : "Cp8oag6", "cluster_name" : "elasticsearch", "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA", "version" : { "number" : "7.7.1", "build_flavor" : "default", "build_type" : "tar", "build_hash" : "f27399d", "build_date" : "2016-03-30T09:51:41.449Z", "build_snapshot" : false, "lucene_version" : "8.5.1", "minimum_wire_compatibility_version" : "1.2.3", "minimum_index_compatibility_version" : "1.2.3" }, "tagline" : "You Know, for Search" }
Elasticsearch 默认使用 /etc/elasticsearch
作为在运行时配置的工具。
该文件夹及其下所有文件的拥有者(owner)都在包安装时被设置为 root:elasticsearch
,该文件夹还有一个 setgid
标识以保证在 /etc/elasticsearch
下创建的文件及子目录都有相同的拥有者(比如,使用 秘钥库工具创建秘钥库)。
我们希望保持这个权限设置,以便 Elasticsearch 进程可以通过组权限读取这个目录下的文件。
Elasticsearch 默认从 /etc/elasticsearch/elasticsearch.yml
文件加载配置。
配置 Elasticsearch 中解释了此配置文件的格式。
RPM 安装包还有一个系统配置文件(/etc/default/elasticsearch
),这使得你可以设置以下参数:
|
设置一个自定义的 Java 路径。 |
|
最大的可开启文件数,默认为 |
|
最大的可锁定内存大小。
如果在配置文件 elasticsearch.yml 中使用 |
|
一个进程可以拥有的最大内存映射区域数。
如果你使用 |
|
配置文件的目录(必须包含 |
|
你可能希望应用的任何其他 JVM 系统属性。 |
|
配置包升级时是否重启,默认为 |
使用 systemd
的发行版要求通过 systemd
配置系统资源限制,而不是通过 /etc/sysconfig/elasticsearch
文件。
更多信息参考 Systemd 配置。
对于基于 RPM 的系统,RPM 安装包将配置文件、日志和数据目录放在适当的位置:
Type | Description | Default Location | Setting |
---|---|---|---|
home |
Elasticsearch 主目录 或 |
|
|
bin |
二进制脚本,包含启动一个节点的 |
|
|
conf |
包含 |
|
|
conf |
环境变量,包括堆内存大小、文件描述符 |
|
|
data |
节点上的每个索引/分片的数据文件的位置。 可以设置多个位置。 |
|
|
jdk |
捆绑的Java开发套件,用于运行Elasticsearch。
可以通过在 |
|
|
logs |
日志文件的存放位置 |
|
|
plugins |
插件文件的存放位置。每个插件都放在一个子文件夹中。 |
|
|
repo |
共享的文件系统存储库的位置。 可以设置多个位置。 可以将文件系统存储库放置到此处指定的任何目录的任何子目录中。 |
未配置 |
|
你现在已经设置了一个 Elasticsearch 测试环境。 在开始正式开发或开始使用 Elasticsearch 进行生产之前,你还必须做一些额外的设置:
- 学习如何 配置 Elasticsearch。
- 配置 重要的 Elasticsearch 设置。
- 配置 重要的系统设置。