安装前说明
- 首先确定操作系统,在Linux发行版上执行
uname -a
查看具体系统。我是Ubuntu系统,可以用直接用apt-get
安装,也可以下载tar.gz
包手动安装。使用apt-get
安装更方便快速,但不同的文件会被安装到不同的目录,不方便管理,下载.tar.gz
包后手动安装文件都在同一个目录下,查看更方便,但安装较为麻烦,请注意取舍。- elasticsearch 安装需要依赖JDK,最新版的安装包会自带JDK(bundled),如果你的环境中没有安装JDK或未配置
JAVA_HOME
环境变量,则会直接使用它自带的JDK,如果你的环境中已经安装有 JDK并配置了JAVA_HOME
环境变量,会优先使用你的 JDK,但需要保证你的JDK版本与 elasticsearch 需要的版本匹配,最好是openjdk。- 我在第一次使用
apt-get
安装时因为未修改默认JVM堆内存配置(4G),导致oom安装失败,所以第二次通过.tar.gz
包安装前将JVM堆内存修改成了1G,你可以按你的环境配置决定。- 本次安装版本为
elasticsearch-8.13.0
注意:请先阅读下面两种安装方式的步骤,选择合适的安装方式后再进行安装
使用 apt-get 安装
注意:这种方式安装安装简单,但 elasticsearch 的各类文件不在同一个目录下,不方便管理
参照 elastic 官方安装指南:https://www.elastic.co/guide/en/elasticsearch/reference/current/install-elasticsearch.html
安装步骤参照 https://www.elastic.co/guide/en/elasticsearch/reference/current/deb.html
按下面步骤依次执行命令:
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg
apt-get install apt-transport-https
echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-8.x.list
sudo apt-get update && sudo apt-get install elasticsearch
运行完上面命令,不出意外就能安装成功,注意,记录下最后打印的超级用户(superuser)的密码,登录使用
。
使用这种方式安装时,安装进程会自动创建elasticsearch.service
,因此可以直接使用systemctl
对 elasticsearch 进程作systemd
管理,因此可以执行如下命令加入开机自启动并启动 elasticsearch 服务:
sudo systemctl daemon-reload
sudo systemctl enable elasticsearch.service
sudo systemctl start elasticsearch.service
不出意外的话,会成功。
但是我出意外了,启动失败(忘记截图了),它告诉我可以用journalctl -xeu elasticsearch.service
命令查看错误原因:
看到oom-kill
就明白了,我的小服务器内存不够它玩。它默认的堆内存大小是4G
,而我的服务器内存总共才4G,所以我需要降低堆内存配置。
这里需要说明的是,正常情况下 elastsearch的安装包下有个config
目录保存的是一些配置文件,但是通过apt-get install
安装的安装目录/usr/share/elasticsearch
下没有config
目录:
于是我就在安装步骤后面找配置文件位置(感兴趣的戳这里查看不同文件所在目录 Directory layout of Debian package),原来配置目录变成了/etc/elasticsearch
:
OK,我需要改jvm
配置,本来想直接改jvm.options
,但是进去发现它建议在jvm.options.d
下自己建文件修改,那好吧,我就在下面单独建了个heap.options
,里面写上配置:
-Xms1g
-Xmx1g
咱这家底,给分个 1G 让它勉强玩玩得了。
OK,修改好并保存后重新启动,执行systemctl start elasticsearch.service
命令,不报错就是成功了。
下载 .tar.gz 安装
这种方式安装较为麻烦,但自主可控。
参考官方安装指南:https://www.elastic.co/guide/en/elasticsearch/reference/current/targz.html
首先下载安装包(官方指南里还会下载tar.gz.sha512
后校验文件,这里省略此步骤),然后解压到当前目录:
# 下载安装包
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-8.13.0-linux-x86_64.tar.gz
# 解压
tar -zxvf elasticsearch-8.13.0-linux-x86_64.tar.gz
上面命令会解压文件到./elasticsearch-8.13.0/
目录,可以看到各类文件都在同一个目录下:
由于上面使用apt-get
安装时已经知道JVM堆内存不够会导致安装失败,故启动前先修改JVM堆内存为1G,修改方式和上面相同,进入./config/jvm.options.d/
目录创建一个heap.options
文件,里面写上配置:
-Xms1g
-Xmx1g
修改后保存,再回到./elasticsearch-8.13.0/
目录,运行启动文件(加上 -d,守护进程启动,否则退出shell后进程就会挂掉):
./bin/elasticsearch -d # -d 表示守护进程启动
不出意外,肯定失败了。报错信息为 fatal exception while booting Elasticsearchjava.lang.RuntimeException: can not run elasticsearch as root。原来 elasticsearch 不允许root
用户进行安装,这是出于安全考虑。
OK,那我们单独新建个用户组 es 和用户 es:
groupadd es #新建用户组 es
useradd es -g es -p 你的密码 # 在 es 用户组下面建 es 用户,并指定你的登录密码
建好新用户后,回到 elasticsearch-8.13.0 的上层目录,为 es 用户授权该目录:
chown -R es:es ./elasticsearch-8.13.0
这时,目录已经属于 es 用户了:
好的很,然后进入elasticsearch-8.13.0 目录,执行su es
命令切换到 es 用户身份,再运行./bin/elasticsearch -d
命令启动:
cd ./elasticsearch-8.13.0
su es
# 切换到 es 后执行
./bin/elasticsearch -d
不出意外,会启动成功:
注意:同上面一样,最后输出的日志非常重要,所以建议复制保存在一个文件中。最后输出的elastic
用户的初始密码
,你需要记录下来,登录时使用,但如果你忘了没记下来,也可以运行./bin/elasticsearch-reset-password -u elastic
重新生成一个。
连接测试
启动成功后我们可以用curl
连接默认端口9200
测试:
curl 127.0.0.1:9200
不出意外,应该会返回 curl: (52) Empty reply from server。这是因为 elasticsearch 默认开启了 xpack 认证,我们刚开始测试阶段,可以先全部关掉。进入.elasticsearch-8.13.0/config/elasticsearch.yml
目录,可以看到与认证相关的配置,这段配置是启动后加上去的,我们将与 xpack 有关的配置修改为 false:
然后重启即可(先ps找到进程id,kill掉后再运行上面的启动命令)。
本机运行 curl 连接:
公网浏览器访问http://ip:9200/
(如果连接失败可检查防火墙或云服务器安全组是否开放9200端口):
发送一条查看节点信息的请求ip:9200/_cat/nodes?v
说明安装完成!
进阶管理
systemd 管理
第二种安装方式是直接执行/bin/elasticsearch
启动脚本启动的,但这样不利于系统化管理,也不能开机自启动,我们可以将进程交给systemd
管理,但是我们需要自定义一个elasticsearch.service
文件。在这篇博客 找到一个现成的elasticsearch.service
模板可以直接用。我们需要创建/etc/systemd/system/elasticsearch.service
文件,将下面内容复制到文件中,注意要修改下Service.User
和 Service.ExecStart
配置:
[Unit]
Description=elasticsearch
After=network.target
[Service]
Type=forking
# ============================== 注意 ================================
# 这里要替换成你自己创建的 elasticsearch 用户
User=es
# 这里要替换成你自己的 elasticsearch 安装目录
ExecStart=/usr/local/elasticsearch-8.13.0/bin/elasticsearch -d
# ===================================================================
PrivateTmp=true
# 指定此进程可以打开的最大文件数
LimitNOFILE=65535
# 指定此进程可以打开的最大进程数
LimitNPROC=65535
# 最大虚拟内存
LimitAS=infinity
# 最大文件大小
LimitFSIZE=infinity
# 超时设置 0-永不超时
TimeoutStopSec=0
# SIGTERM是停止java进程的信号
KillSignal=SIGTERM
# 信号只发送给给JVM
KillMode=process
# java进程不会被杀掉
SendSIGKILL=no
# 正常退出状态
SuccessExitStatus=143
[Install]
WantedBy=multi-user.target
创建好 .service 文件后,依次执行下面命令生效并启动elasticsearch
服务:
systemctl daemon-reload
systemctl enable elasticsearch.service
systemctl start elasticsearch.service
服务状态处于running
,说明启动成功!