当前位置：首页 > news >正文

openEuler安装elasticSearch

news 2026/3/26 23:23:02

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

检查系统架构与依赖
openEuler 分为aarch64（鲲鹏等 ARM 架构）和x86_64（x86 架构），ES 提供对应架构的安装包，先确认系统架构：
bash
运行

查看系统架构

uname -m

输出：aarch64 或 x86_64

关闭防火墙与 SELinux（测试环境，生产环境可开放指定端口）
bash
运行

关闭防火墙

systemctl stop firewalld
systemctl disable firewalld

临时关闭SELinux

setenforce 0

永久关闭SELinux（修改后需重启）

sed -i ‘s/^SELINUX=enforcing/SELINUX=disabled/’ /etc/selinux/config
3. 调整系统内核参数（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 版本信息即为安装成功。