在CentOS 7上以rpm方式安装Elasticsearch 7.4.0

曾经终败给现在 2022-12-15 12:40 246阅读 0赞

### 文章目录 ###

*  在CentOS 7上以rpm方式安装Elasticsearch 7.4.0
 *   *  前言
     *  安装前准备
     *  下载安装包
     *  安装Elasticsearch
     *  Elasticsearch目录
     *  配置Elasticsearch
     *   *  配置JVM参数
         *  配置数据目录和日志目录
     *  以服务方式启动Elasticsearch
     *  验证Elasticsearch
     *  安装Kibana
     *  Troubleshooting
     *   *  问题1: unable to create temporary keystore
     *  使用指定的JDK
     *  后记
     *  参考文档

# 在CentOS 7上以rpm方式安装Elasticsearch 7.4.0 #

## 前言 ##

本文描述了如何在CentOS7上以rpm方式安装单机版Elasticsearch 7.4.0。

环境：

*  CentOS7 64位
 *  Elasticsearch 7.4.0 自带的OpenJDK 13
 *  Elasticsearch 7.4.0

## 安装前准备 ##

## 下载安装包 ##

官方文档：

*  [https://www.elastic.co/guide/en/elasticsearch/reference/current/rpm.html][https_www.elastic.co_guide_en_elasticsearch_reference_current_rpm.html]
 *  [https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html\#jvm-version][https_www.elastic.co_guide_en_elasticsearch_reference_current_setup.html_jvm-version]

Elasticsearch 7.4.0下载地址：

*  [https://www.elastic.co/cn/downloads/past-releases/elasticsearch-7-4-0][https_www.elastic.co_cn_downloads_past-releases_elasticsearch-7-4-0]

Elasticsearch最新版本下载地址：

*  [https://www.elastic.co/cn/downloads/elasticsearch][https_www.elastic.co_cn_downloads_elasticsearch]

下载Elasticsearch 7.4.0的rpm包和sha512校验和文件：

# download rpm package
    wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.4.0-x86_64.rpm
    
    # download rpm sha
    wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.4.0-x86_64.rpm.sha512

检查sha512校验和：

sha512sum -c elasticsearch-7.4.0-x86_64.rpm.sha512

## 安装Elasticsearch ##

以rpm方式安装Elasticsearch：

rpm -ivh elasticsearch-7.4.0-x86_64.rpm

> 安装时可能会遇到无法创建Elasticsearch keystore的问题，参见下面的Troubleshooting章节。

## Elasticsearch目录 ##

配置目录为`/etc/elasticsearch`，其中：

*  `jvm.options` 为JVM参数配置，JVM参数调优时主要就是修改这个文件。
    
     *  默认参数为`-Xms1g -Xmx1g`
 *  `elasticsearch.yml` 为Elasticsearch配置文件
 *  `elasticsearch.keystore`为密钥证书

程序目录为`/usr/share/elasticsearch`，其中：

*  `plugins` 为插件目录
 *  `bin` 为执行文件目录
    
     *  `elasticsearch` 为Elasticsearch执行文件
     *  `elasticsearch-env` 为Elaticsearch设置环境变量程序
 *  `jdk` 为自带的OpenJDK目录
 *  `lib` 为库文件目录
 *  `modules` 为模块目录

数据目录默认为`/var/lib/elasticsearch`。

日志目录默认为`/var/log/elasticsearch`。

数据目录和日志目录在`/etc/elasticsearch/elasticsearch.yml`中定义。

## 配置Elasticsearch ##

修改Elasticsearch配置后，需要重启Elasticsearch服务：

sudo systemctl restart elasticsearch

### 配置JVM参数 ###

参见：

*  [https://www.elastic.co/guide/en/elasticsearch/reference/current/heap-size.html][https_www.elastic.co_guide_en_elasticsearch_reference_current_heap-size.html]

小结：

*  Xmx和Xms设置成一样
 *  Xmx和Xms不超过物理内存的50% (ES还会使用操作系统管理的直接内存，direct buffer)
 *  Xmx和Xms不超过32 GB，一般地建议最大值不超过26 GB (防止JVM对象指针压缩问题，compressed object pointer)

在我的机器上物理内存为 8 GB，JVM参数设置为：

-Xms4g
    -Xmx4g

关于Linux的内存使用情况，参见：

*  [9个必须掌握的Linux性能调优命令和工具][9_Linux]

在我的机器上，将数据目录和日志目录放在挂载的另一块磁盘（`/mnt/data`）上：

# data path
    mkdir -p /mnt/data/elasticsearch/data/
    chown -R elasticsearch:elasticsearch /mnt/data/elasticsearch/data/
    
    # log path
    mkdir -p /mnt/data/elasticsearch/log/
    chown -R elasticsearch:elasticsearch /mnt/data/elasticsearch/log/

修改`/etc/elasticsearch/elasticsearch.yml`，配置新的数据目录和日志目录。

修改前：

path.data: /var/lib/elasticsearch
    path.logs: /var/log/elasticsearch

修改后：

path.data: /mnt/data/elasticsearch/data/
    path.logs: /mnt/data/elasticsearch/log/

## 以服务方式启动Elasticsearch ##

以服务方式启动Elasticsearch：

sudo systemctl daemon-reload
    sudo systemctl enable elasticsearch
    sudo systemctl start elasticsearch

查看Elasticsearch服务状态：

sudo systemctl status elasticsearch -l

查看服务的详细日志：

journalctl -xefu elasticsearch

## 验证Elasticsearch ##

运行`ps -ef | grep elasticsearch` 查看Elasticsearch进程，包括JVM参数。

运行以下命令，获取Elasticsearch安装的基本信息：

curl http://127.0.0.1:9200

## 安装Kibana ##

根据需要可以安装Kibana和其他工具，比如Logstash。

## Troubleshooting ##

### 问题1: unable to create temporary keystore ###

错误日志：

elasticsearch[29608]: Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: org.elasticsearch.cli.UserException: unable to create temporary keystore at [/etc/elasticsearch/elasticsearch.keystore.tmp], please check filesystem permissions
    elasticsearch[29608]: Likely root cause: java.nio.file.AccessDeniedException: /etc/elasticsearch/elasticsearch.keystore.tmp

解决方法：

/usr/share/elasticsearch/bin/elasticsearch-keystore create

可以忽略日志中的Java version的警告：

future versions of Elasticsearch will require Java 11; your Java version from [/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.242.b08-0.el7_7.x86_64/jre] does not meet this requirement
    Created elasticsearch keystore in /etc/elasticsearch

检查/etc/elasticsearch目录，elasticsearch.keystore 文件已经创建成功。

参见：

*  [https://github.com/elastic/elasticsearch/pull/41755][https_github.com_elastic_elasticsearch_pull_41755]
 *  [https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-keystore.html][https_www.elastic.co_guide_en_elasticsearch_reference_current_elasticsearch-keystore.html]

## 使用指定的JDK ##

Elasticsearch官方文档上写，如果设置了`JAVA_HOME`环境变量，则不会使用自带的JDK。  
但是通过查看进程`ps -ef | grep elasticsearch` 和查看服务启动日志`systemctl status elasticsearch -l` 发现，Elasticsearch服务启动时，仍然使用自带的JDK `/usr/share/elasticsearch/jdk/bin/java`。

检查Java版本：

java -version
    javac -version

检查JAVA\_HOME：

echo $JAVA_HOME

参见：

*  [CentOS7上安装OpenJDK8][CentOS7_OpenJDK8]

## 后记 ##

Elasticsearch有2种license：

*  Elasticsearch License （[Elasticsearch][https_www.elastic.co_cn_downloads_elasticsearch]）：可以免费使用，包含了一些可以免费试用30天的商用特性
 *  Apache 2 License （[Elasticsearch OSS][]）：遵循Apache 2 License的开源版本，可以免费试用，不包含商用特性

小结：

*  如果只是免费使用，选择哪个版本都可以。
 *  如果考虑付费使用商用特性，选择Elasticsearch版本。
 *  如果要修改Elasticsearch源代码，则只能使用Elasticsearch OSS版本。

## 参考文档 ##

*  [https://serverguy.com/magento/install-elasticsearch-on-centos-7/][https_serverguy.com_magento_install-elasticsearch-on-centos-7]
 *  [https://www.myfreax.com/how-to-install-elasticsearch-on-centos-7/][https_www.myfreax.com_how-to-install-elasticsearch-on-centos-7]
 *  [https://www.linjiangxiong.com/2020/06/16/install-elasticsearch-on-centos-7/][https_www.linjiangxiong.com_2020_06_16_install-elasticsearch-on-centos-7]
 *  [https://linuxize.com/post/how-to-install-rpm-packages-on-centos/][https_linuxize.com_post_how-to-install-rpm-packages-on-centos]

[https_www.elastic.co_guide_en_elasticsearch_reference_current_rpm.html]: https://www.elastic.co/guide/en/elasticsearch/reference/current/rpm.html
[https_www.elastic.co_guide_en_elasticsearch_reference_current_setup.html_jvm-version]: https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html#jvm-version
[https_www.elastic.co_cn_downloads_past-releases_elasticsearch-7-4-0]: https://www.elastic.co/cn/downloads/past-releases/elasticsearch-7-4-0
[https_www.elastic.co_cn_downloads_elasticsearch]: https://www.elastic.co/cn/downloads/elasticsearch
[https_www.elastic.co_guide_en_elasticsearch_reference_current_heap-size.html]: https://www.elastic.co/guide/en/elasticsearch/reference/current/heap-size.html
[9_Linux]: https://cookcode.blog.csdn.net/article/details/106870787
[https_github.com_elastic_elasticsearch_pull_41755]: https://github.com/elastic/elasticsearch/pull/41755
[https_www.elastic.co_guide_en_elasticsearch_reference_current_elasticsearch-keystore.html]: https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-keystore.html
[CentOS7_OpenJDK8]: https://cookcode.blog.csdn.net/article/details/89413178
[Elasticsearch OSS]: https://www.elastic.co/cn/downloads/elasticsearch-oss
[https_serverguy.com_magento_install-elasticsearch-on-centos-7]: https://serverguy.com/magento/install-elasticsearch-on-centos-7/
[https_www.myfreax.com_how-to-install-elasticsearch-on-centos-7]: https://www.myfreax.com/how-to-install-elasticsearch-on-centos-7/
[https_www.linjiangxiong.com_2020_06_16_install-elasticsearch-on-centos-7]: https://www.linjiangxiong.com/2020/06/16/install-elasticsearch-on-centos-7/
[https_linuxize.com_post_how-to-install-rpm-packages-on-centos]: https://linuxize.com/post/how-to-install-rpm-packages-on-centos/