RPM安装方式

Elasticsearch的RPM软件包可以从我们的网站下载或从我们的APT仓库安装。它可以用于任何基于RPM的系统上安装Elasticsearch，如OpenSuse、SLES、Centos、Red Hat与企业级Oracle。

注意

RPM包不支持老的RPM平台，譬如SLES 11与CentOS 5，这些平台请采用.zip或.tar.gz文件的安装方式。

注意

Elasticsearch需要Java 8或更高版本。可以使用Oracle官方发布或开源版本的OpenJDK。

Elasticsearch的最新稳定版本可以在Elasticsearch下载页面获取。其它版本可以在上之前的下载页面找到。

导入Elasticsearch PGP Key

Elasticsearch的所有包都采用如下指纹与签名Key进行签名（PGP key D88E42B4，可从https://pgp.mit.edu）：

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

下载并安装该公用签名密钥：

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

从RPM仓库中安装

在基于RedHat的平台中请在/etc/yum.repos.d/文件夹下创建一个elasticsearch.repo文件，在基于OpenSuse的平台中请在/etc/zypp/repos.d/文件夹下创建一个elasticsearch.repo文件，内容如下：

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

你的仓库就准备好了，你可以采用下面的命令来安装它：

sudo yum install elasticsearch #①
sudo dnf install elasticsearch #②
sudo zypper install elasticsearch #③

① 在CentOS与老的Red Hat发行版本中使用yum指令 ② 在Fedora与新的Red Hat发行版本中使用dnf指令 ③ 在OpenSuse的发行版本中使用zypper指令

手动下载并安装RPM软件包

Elasticsearch的5.3.0版本RPM安装包可以通过如下指令从网站下载与安装：

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.3.0.rpm
sha1sum elasticsearch-5.3.0.rpm #①
sudo rpm --install elasticsearch-5.3.0.rpm

① 通过sha1sum或shasum比较官方发布的SHA公钥

SysV init vs systemd

Elasticsearch不是在安装后自动启动。如何启动和停止Elasticsearch取决于你的系统是否使用的SysV init或system（较新发行版中使用）。你可以说这是一个用来运行以下命令：

ps -p 1

通过SysV init启动Elasticsearch

使用chkconfig命令来配置Elasticsearch在系统启动时自动启动:

sudo chkconfig --add elasticsearch

Elasticsearch可以通过service命令来启动与停止：

sudo -i service elasticsearch start
sudo -i service elasticsearch stop

任何原因的Elasticsearch启动失败，都会将原因打印到控制套。日志文件可以在/var/log/elasticsearch/中找到。

通过systemd启动Elasticsearch

要配置Elasticsearch在系统启动时自动启动，运行以下命令：

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

Elasticsearch可以通过service命令来启动与停止：

sudo systemctl start elasticsearch.service
sudo systemctl stop elasticsearch.service

无论Elasticsearch是否成功没有启动, 这些命令不提供反馈。相反，该信息将被写入位于/var/log/elasticsearch/的日志文件中。

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

当systemd启用了日志记录，日志信息的使用可用journalctl命令：

tail查看journal:

sudo journalctl -f

要列出journal中elasticsearch服务的日志条目：

sudo journalctl --unit elasticsearch

要列出指定时间之后的列出journal中elasticsearch服务的日志条目：

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

更多的journalctl操作手册，请参考：https://www.freedesktop.org/software/systemd/man/journalctl.html。

检查Elasticsearch运行

您可以在已运行的Elasticsearch节点上，发送一个HTTP请求测试localhost的9200端口：

GET /

返回的消息应该是这样的：

{
  "name" : "Cp8oag6",
  "cluster_name" : "elasticsearch",
  "cluster_uuid" : "AT69_T_DTp-1qgIJlatQqA",
  "version" : {
    "number" : "5.3.0",
    "build_hash" : "f27399d",
    "build_date" : "2016-03-30T09:51:41.449Z",
    "build_snapshot" : false,
    "lucene_version" : "6.4.1"
  },
  "tagline" : "You Know, for Search"
}

配置Elasticsearch

Elasticsearch默认从/etc/elasticsearch/elasticsearch.yml文件中加载配置。这个配置文件的格式说明请参考Elasticsearch配置。

RPM软件包也有一个系统配置文件（/etc/sysconfig/elasticsearch），它允许你设置以下参数：

参数名	描述
ES_USER	运行的用户，默认为elasticsearch。
ES_GROUP	运行的Group，默认为elasticsearch。
JAVA_HOME	自定义java路径。
MAX_OPEN_FILES	最大的打开文件数，默认最大数量65536。
MAX_LOCKED_MEMORY	最大锁定内存大小。你使用bootstrap.memory_lock的elasticsearch.yml选项将被设置为unlimited。
MAX_MAP_COUNT	进程的内存映射区域最大数量。如果你使用mmapfs的索引存储类型，确保此项设置为高值。欲了解更多信息，请查看Linux内核文件查看相关的max_map_count。这是在启动elasticsearch之前通过sysctl设置的，默认为262144。
LOG_DIR	日志目录，默认为/var/log/elasticsearch。
DATA_DIR	Data目录，默认为/var/lib/elasticsearch。
CONF_DIR	配置文件目录（其中必须包括elasticsearch.yml和log4j2.properties文件），默认为/etc/elasticsearch。
ES_JAVA_OPTS	任何额外的JVM系统属性，你可能要应用。
RESTART_ON_UPGRADE	配置在安装包升级后重启，默认为false。这意味着你将在安装包后需要手动重新启动您的elasticsearch实例。这样做的原因是为了保证，在群集升级时不会连续的重新分配分片导致高网络流量、并降低群集的响应时间。

注意

使用systemd部署需要配置systemd的系统资源限制，而不是通过/etc/sysconfig/elasticsearch文件。更多信息请参见：系统设置。

RPM目录结构

RPM包中配置文件、日志和数据目录在RPM-based系统中对应的位置:

类型	描述	默认位置	设置方式
home	Elasticsearch主目录或 $ES_HOME	/usr/share/elasticsearch
bin	二进制脚本，包括启动节点的elasticsearch、安装插件的elasticsearch-plugin	/usr/share/elasticsearch/bin
conf	配置文件，包括lasticsearch.yml	/etc/elasticsearch	path.conf
conf	环境变量，包括heap大小、文件操作符	/etc/sysconfig/elasticsearch
data	节点上分配的各索引/分片的数据文件的目录，可以配置多个位置。	/var/lib/elasticsearch	path.data
log	日志文件的位置。	/var/log/elasticsearch	path.logs
plugins	插件的位置。每一个插件将被包含在一个子目录。	/usr/share/elasticsearch/plugins
repo	共享文件系统存储库位置。可以容纳多个位置。文件系统存储库可以放在这里指定的任意目录中的任何子目录。	未配置	path.repo
script	脚本文件位置。	/etc/elasticsearch/scripts	path.scripts

下一步

现在，您搭建了一个测试环境Elasticsearch。开始更深入的研究或投入生产使用Elasticsearch之前，你需要做一些额外的配置：

• 了解如何配置Elasticsearch。

• 配置重要的Elasticsearch设置。

• 配置重要的系统设置。