使用RPM安装Elasticsearch-《elasticsearch中文文档帮助手册教程V7.11》

admin 2025-11-04 00:23:24 数据库 来源:ZONE.CI 全球网 0 阅读模式
  • 使用 RPM 安装 Elasticsearch
    • 导入 Elasticsearch PGP 密钥
    • 从 RPM 仓库安装
    • 手工下载和安装 RPM
    • 启用系统索引自动创建 [X-Pack]
    • SysV initsystemd
    • 使用 SysV init 运行 Elasticsearch
    • 使用 systemd 运行 Elasticsearch
    • 检查 Elasticsearch 是否正在运行
    • 配置 Elasticsearch
    • RPM 目录结构
    • 下一步

    使用 RPM 安装 Elasticsearch

    Elasticsearch 的 RPM 可以从我们的网站或者从我们的 RPM 仓库下载。它可以用于在任何基于 RPM 的系统(如 OpenSuSE,SLES,Centos,Red Hat 和 Oracle Enterprise)上安装 Elasticsearch。

    ?> 老版本的 RPM 发行版本(如 SLES 11 和 CentOS 5)不支持 RPM 安装。请参阅 在 Linux 或 MacOS 上用存档安装 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

    下载和安装公共签名密钥:

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

    从 RPM 仓库安装

    为基于 RedHat 的发行版,在目录 /etc/yum.repos.d/ 中创建一个命名为 elasticsearch.repo 的文件,或者为基于 OpenSuSE 的发行版在目录 /etc/zypp/repos.d/ 中创建文件,内容包括:

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

    仓库已准备就绪。现在可以使用以下的任一命令安装 Elasticsearch:

    1. sudo yum install --enablerepo=elasticsearch elasticsearch
    2. sudo dnf install --enablerepo=elasticsearch elasticsearch
    3. sudo zypper modifyrepo --enable elasticsearch && \
    4. sudo zypper install elasticsearch; \
    5. sudo zypper modifyrepo --disable elasticsearch
    • sudo yum install 在 CentOS 和老的基于 Red Hat 的发行版上使用 yum
    • sudo dnf install 在 Fedora 和其他新的 Red Hat 的发行版上使用 dnf
    • sudo zypper modifyrepo 在基于 OpenSUSE 的发行版本上使用 zypper

    ?> 配置的仓库默认是禁用的。这排除了升级系统其他部分时意外升级 Elasticsearch 的可能性。每个安装或者升级命令必须显示启用仓库,如上面的示例命令所示。

    手工下载和安装 RPM

    Elasticsearch v7.11.2 的 RPM,可以按以下命令从网站下载和安装:

    1. wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.2-x86_64.rpm
    2. wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.11.2-x86_64.rpm.sha512
    3. shasum -a 512 -c elasticsearch-7.11.2-x86_64.rpm.sha512
    4. sudo rpm --install elasticsearch-7.11.2-x86_64.rpm
    • shasum -a 512 -c 比较下载的 RPM SHA 值和公开的校验值。正常应该输出 elasticsearch-{version}-x86_64.rpm: OK

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

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

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

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

    SysV initsystemd

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

    1. ps -p 1

    使用 SysV init 运行 Elasticsearch

    使用 update-rc.d 命令配置当系统启动时自动启动 Elasticsearch:

    1. sudo update-rc.d elasticsearch defaults 95 10

    Elasticsearch 可以使用 service 命令来启动和停止:

    1. sudo -i service elasticsearch start
    2. sudo -i service elasticsearch stop

    如果 Elasticsearch 由于任何原因启动失败,它会输出失败原因到标准输出(STDOUT)。日志文件可以在 /var/log/elasticsearch/ 中被找到。

    使用 systemd 运行 Elasticsearch

    为了配置 Elasticsearch 在系统启动时自动启动,运行以下命令:

    1. sudo /bin/systemctl daemon-reload
    2. sudo /bin/systemctl enable elasticsearch.service

    Elasticsearch 可以按以下方式启动和停止:

    1. sudo systemctl start elasticsearch.service
    2. sudo systemctl stop elasticsearch.service

    这些命令不提供 Elasticsearch 运行成功与否的反馈。相反,信息写在位于 /var/log/elasticsearch/ 中的日志文件。

    如果你的 Elasticsearch 密码库受密码保护,你需要使用本地文件和 systemd 环境变量向密码库提供密码。本地文件存在时,应该受到保护,一旦 Elasticsearch 启动并运行,就可以安全删除此文件。

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

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

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

    要跟踪日志:

    1. sudo journalctl -f

    列出 Elasticsearch 服务的日志条目:

    1. sudo journalctl --unit elasticsearch

    要列出从给定时间开始的 Elasticsearch 服务的日志条目,请执行以下操作:

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

    检查 man journalctl 或者 https://www.freedesktop.org/software/systemd/man/journalctl.html 获取更多的命令行选项。

    检查 Elasticsearch 是否正在运行

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

    1. GET /

    这会给你这样的响应:

    1. {
    2. "name" : "Cp8oag6",
    3. "cluster_name" : "elasticsearch",
    4. "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
    5. "version" : {
    6. "number" : "7.11.2",
    7. "build_flavor" : "default",
    8. "build_type" : "tar",
    9. "build_hash" : "f27399d",
    10. "build_date" : "2016-03-30T09:51:41.449Z",
    11. "build_snapshot" : false,
    12. "lucene_version" : "8.7.0",
    13. "minimum_wire_compatibility_version" : "1.2.3",
    14. "minimum_index_compatibility_version" : "1.2.3"
    15. },
    16. "tagline" : "You Know, for Search"
    17. }

    配置 Elasticsearch

    /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),它允许你设置以下的变量:

    JAVA_HOME 设置使用的自定义 Java 路径
    MAX_OPEN_FILES 打开文件的最大值,默认为 65535
    MAX_LOCKED_MEMORY 最大锁定内存值。如果你在 elasticsearch.yml 中使用 bootstrap.memory_lock 选项,设置为 unlimited
    MAX_MAP_COUNT 进程可能具有的最大内存映射区域数。如果你使用 mmapfs 作为索引存储类型,请确保将其设置一个高值。有关更多的信息,请查看关于 max_map_count 的 linux 内核文档。在 Elasticsearch 启动前,通过 sysctl 设置,默认为 262144
    ES_PATH_CONF 配置文件目录(需要包含 elasticsearch.ymljvm.optionslog4j2.properties 文件),默认为 /etc/elasticsearch
    ES_JAVA_OPTS 你想应用的任何其他 JVM 系统属性。
    RESTART_ON_UPGRADE 在包升级时配置重启,默认为 false。这意味着你必须在手工安装包后重启你的 Elasticseach 实例。这样做的原因是为了确保集群的升级不会导致持续的分片重分配,进而导致的高网络流量和降低了集群的响应时间。

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

    RPM 目录结构

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

    类型 描述 默认位置 设置
    home Elasticsearch 主目录或 $ES_HOME /usr/share/elasticsearch
    bin 二进制脚本,包括启动节点的 elasticsearch 和安装插件的 elasticsearch-plugin /usr/share/elasticsearch/bin
    conf 配置文件,包括 elasticsearch.yml /etc/elasticsearch ES_PATH_CONF
    conf 环境变量,包括堆大小,文件描述符。 /etc/default/elasticsearch
    data 分配在节点上的每个索引和分片的数据文件位置。可以有多个位置。 /var/lib/elasticsearch path.data
    jdk 用于运行 Elasticsearch 的捆绑 Java 开发工具包。可以通过在 /etc/sysconfig/elasticsearch 中覆盖 JAVA_HOME环境变量。 /usr/share/elasticsearch/jdk
    logs 日志文件位置 /var/log/elasticsearch path.logs
    plugins 插件文件位置。每个插件会包含在一个子目录中。 /usr/share/elasticsearch/plugins
    repo 共享文件系统仓库位置。可以有多个位置。文件系统仓库可以放在此处指定的任何目录的任何子目录中。 未配置 path.repo

    下一步

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

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

    原文链接

    评论:0   参与:  34