openEuler安装elasticSearch

在 openEuler 系统中安装 Elasticsearch(以下简称 ES),我将以 ES 7.17.5(长期支持版,适配性强) 为例,提供从环境准备、安装配置到启动验证的完整步骤,同时兼顾 openEuler 的系统特性(如 aarch64/x86_64 架构适配、权限管理等)。

一、环境准备(必做!避免安装后启动失败)

  1. 检查系统架构与依赖
    openEuler 分为aarch64(鲲鹏等 ARM 架构)和x86_64(x86 架构),ES 提供对应架构的安装包,先确认系统架构:
    bash
    运行

查看系统架构

uname -m

输出:aarch64 或 x86_64

  1. 关闭防火墙与 SELinux(测试环境,生产环境可开放指定端口)
    bash
    运行

关闭防火墙

systemctl stop firewalld

systemctl disable firewalld

临时关闭SELinux

setenforce 0

永久关闭SELinux(修改后需重启)

sed -i 's/^SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

  1. 调整系统内核参数(ES 对系统资源有特定要求)

编辑/etc/security/limits.conf,添加以下内容(提升用户资源限制):

bash

运行

vi /etc/security/limits.conf

ini

Elasticsearch 用户资源限制

elasticsearch soft nofile 65535

elasticsearch hard nofile 65535

elasticsearch soft nproc 4096

elasticsearch hard nproc 4096

elasticsearch soft memlock unlimited

elasticsearch hard memlock unlimited

编辑/etc/sysctl.conf,添加内核参数:

bash

运行

vi /etc/sysctl.conf

ini

ES 所需内核参数

vm.max_map_count=262144

fs.file-max=655350

net.ipv4.ip_local_port_range=1024 65535

使内核参数生效:

bash

运行

sysctl -p

二、安装 Elasticsearch

方式 1:使用二进制包安装(推荐,适配所有架构)

步骤 1:下载对应架构的 ES 安装包

bash

运行

先创建安装目录

mkdir -p /usr/share/elasticsearch

cd /usr/local/src

若为x86_64架构

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.5-linux-x86_64.tar.gz

若为aarch64架构(鲲鹏)

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.5-linux-aarch64.tar.gz

步骤 2:解压安装包

bash

运行

替换为对应架构的包名

x86_64架构

tar -zxvf elasticsearch-7.17.5-linux-x86_64.tar.gz -C /usr/share/

aarch64架构

tar -zxvf elasticsearch-7.17.5-linux-aarch64.tar.gz -C /usr/share/

重命名目录(简化路径)

mv /usr/share/elasticsearch-7.17.5-* /usr/share/elasticsearch

步骤 3:创建专用运行用户(ES 禁止 root 用户运行)

bash

运行

创建elasticsearch用户

useradd -r -s /sbin/nologin elasticsearch

赋予目录权限

chown -R elasticsearch:elasticsearch /usr/share/elasticsearch

方式 2:使用 RPM 包安装(适用于 x86_64/aarch64,需配置 yum 源)

若偏好 RPM 包管理,可配置 Elastic 的 yum 源后安装:

bash

运行

创建yum源文件

vi /etc/yum.repos.d/elastic.repo

ini

elastic-7.x

name=Elastic 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=1

autorefresh=1

type=rpm-md

安装 ES:

bash

运行

yum install elasticsearch-7.17.5 -y

RPM包安装的目录为 /usr/share/elasticsearch,与二进制包一致

三、配置 Elasticsearch

步骤 1:修改核心配置文件elasticsearch.yml

配置文件位于/usr/share/elasticsearch/config/elasticsearch.yml,编辑如下:

bash

运行

vi /usr/share/elasticsearch/config/elasticsearch.yml

yaml

1. 集群名称(单节点也需配置)

cluster.name: my-es-cluster

2. 节点名称(自定义)

node.name: es-node-1

3. 网络配置:允许外部访问

network.host: 0.0.0.0 # 监听所有网卡,默认仅本地127.0.0.1

http.port: 9200 # HTTP端口

4. 单节点模式(测试环境,生产环境需配置集群)

discovery.type: single-node

5. 数据与日志存储路径(可选,默认在data和logs目录)

path.data: /var/lib/elasticsearch

path.logs: /var/log/elasticsearch

6. 可选:关闭X-Pack安全功能(测试环境,生产环境建议开启)

xpack.security.enabled: false

步骤 2:创建数据与日志目录并赋权

bash

运行

创建目录

mkdir -p /var/lib/elasticsearch /var/log/elasticsearch

赋予权限

chown -R elasticsearch:elasticsearch /var/lib/elasticsearch /var/log/elasticsearch

步骤 3:调整 JVM 内存配置(关键!避免内存不足)

编辑/usr/share/elasticsearch/config/jvm.options,根据服务器内存调整:

bash

运行

vi /usr/share/elasticsearch/config/jvm.options

ini

初始堆内存与最大堆内存,建议为物理内存的1/4(如4G内存设置为1G,8G内存设置为2G)

-Xms1g

-Xmx1g

若服务器内存小于2G,可设置为512m:

-Xms512m

-Xmx512m

四、配置 systemd 服务(开机自启)

步骤 1:创建 systemd 服务文件

bash

运行

vi /etc/systemd/system/elasticsearch.service

写入以下内容:

ini

Unit

Description=Elasticsearch

Documentation=https://www.elastic.co

Wants=network-online.target

After=network-online.target

Service

Type=simple

User=elasticsearch

Group=elasticsearch

Environment="ES_JAVA_OPTS=-Xms1g -Xmx1g"

ExecStart=/usr/share/elasticsearch/bin/elasticsearch -p /var/run/elasticsearch/elasticsearch.pid

RuntimeDirectory=elasticsearch

RuntimeDirectoryMode=0755

Restart=on-failure

LimitNOFILE=65535

LimitNPROC=4096

LimitMEMLOCK=infinity

Install

WantedBy=multi-user.target

步骤 2:重新加载 systemd 配置

bash

运行

systemctl daemon-reload

五、启动并验证 Elasticsearch

步骤 1:启动 ES 服务

bash

运行

启动服务

systemctl start elasticsearch

设置开机自启

systemctl enable elasticsearch

步骤 2:验证服务状态

bash

运行

查看服务状态

systemctl status elasticsearch

查看端口监听(9200端口应处于LISTEN状态)

ss -tulpn | grep 9200

步骤 3:验证 ES 是否正常运行

bash

运行

访问ES的HTTP接口

curl http://localhost:9200

若返回如下信息,说明 ES 安装成功:

json

{

"name" : "es-node-1",

"cluster_name" : "my-es-cluster",

"cluster_uuid" : "xxxxxxxxxxxxxx",

"version" : {

"number" : "7.17.5",

"build_flavor" : "default",

"build_type" : "tar",

"build_hash" : "xxxxxxxxxxxxxx",

"build_date" : "2023-01-31T05:34:48.263135707Z",

"build_snapshot" : false,

"lucene_version" : "8.11.1",

"minimum_wire_compatibility_version" : "6.8.0",

"minimum_index_compatibility_version" : "6.0.0-beta1"

},

"tagline" : "You Know, for Search"

}

六、常见问题处理

启动失败:max virtual memory areas vm.max_map_count [65530] is too low

解决:执行sysctl -w vm.max_map_count=262144,并写入/etc/sysctl.conf永久生效。

启动失败:memory locking requested for elasticsearch process but memory is not locked

解决:确保/etc/security/limits.conf中配置了memlock unlimited,并重启服务器生效。

外部无法访问 9200 端口

解决:检查防火墙是否关闭,或开放 9200 端口:firewall-cmd --add-port=9200/tcp --permanent && firewall-cmd --reload。

总结

核心步骤:openEuler 安装 ES 需先调整系统内核参数和资源限制,再根据架构选择对应安装包,配置核心参数后启动。

关键配置:network.host: 0.0.0.0允许外部访问,discovery.type: single-node适配单节点测试环境,JVM 内存需根据服务器配置调整。

验证标准:curl http://localhost:9200返回 ES 版本信息即为安装成功。

相关推荐
Herlie2 小时前
AI 创业这三年:我的三次认知迭代与自我修正
大数据·人工智能
RemainderTime2 小时前
(十)Spring Cloud Alibaba 2023.x:生产级 CI/CD 全链路实战(从 Dockerfile 到 Jenkins)
运维·spring cloud·ci/cd·docker·jenkins
光仔December2 小时前
【Elasticsearch入门到落地】19、ElasticSearch深度分页问题解决方案:search_after技术详解
elasticsearch·scroll·search_after·from+size·pit
PNP Robotics2 小时前
聚焦具身智能,PNP机器人展出力反馈遥操作,VR动作捕捉等方案,获得中国科研贡献奖
大数据·人工智能·python·学习·机器人
木易 士心2 小时前
数字身份的通行证:深入解析单点登录(SSO)的架构与艺术
java·大数据·架构
2401_878820472 小时前
ES知识点二
大数据·elasticsearch·搜索引擎
Jackyzhe2 小时前
Flink源码阅读:Checkpoint机制(下)
大数据·flink
科创致远3 小时前
esop系统可量化 ROI 投资回报率客户案例故事-案例1:宁波某精密制造企业
大数据·人工智能·制造·精益工程
旺仔Sec11 小时前
2025年安徽省职业院校技能大赛(中职组)大数据应用与服务赛项样题
大数据