> For the complete documentation index, see [llms.txt](https://aqlu.gitbook.io/elasticsearch-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aqlu.gitbook.io/elasticsearch-reference/setup_elasticsearch/installing_elasticsearch/install_elasticsearch_with_rpm.md).

# RPM安装方式

Elasticsearch的RPM软件包可以从[我们的网站下载](/elasticsearch-reference/setup_elasticsearch/installing_elasticsearch/install_elasticsearch_with_rpm.md#install-rpm)或从[我们的APT仓库](/elasticsearch-reference/setup_elasticsearch/installing_elasticsearch/install_elasticsearch_with_rpm.md#rpm-repo)安装。它可以用于任何基于RPM的系统上安装Elasticsearch，如OpenSuse、SLES、Centos、Red Hat与企业级Oracle。

> 注意
>
> RPM包不支持老的RPM平台，譬如SLES 11与CentOS 5，这些平台请采用[.zip或.tar.gz文件的安装方式](https://github.com/aqlu/elasticsearch-reference-cn/tree/571eeb8b33b6a7cef7c250f8bf130d3cc0dfe67d/Setup_Elasticsearch/Installing_Elasticsearch/Installing_Elasticsearch/Install_Elasticsearch_with_.zip_or_.tar.gz.md)。
>
> 注意
>
> Elasticsearch需要Java 8或更高版本。可以使用[Oracle官方发布](http://www.oracle.com/technetwork/java/javase/downloads/index.html)或开源版本的[OpenJDK](http://openjdk.java.net/)。

Elasticsearch的最新稳定版本可以在[Elasticsearch下载](https://www.elastic.co/downloads/elasticsearch)页面获取。其它版本可以在上[之前的下载页面](https://www.elastic.co/downloads/past-releases)找到。

## 导入Elasticsearch PGP Key

Elasticsearch的所有包都采用如下指纹与签名Key进行签名（PGP key [D88E42B4](https://pgp.mit.edu/pks/lookup?op=vindex\&search=0xD27D666CD88E42B4)，可从[https://pgp.mit.edu](https://pgp.mit.edu/)）：

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

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

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

## 从RPM仓库中安装

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

```bash
[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
```

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

```bash
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安装包可以通过如下指令从网站下载与安装：

```bash
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公钥](https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.3.0.rpm.sha1)

## `SysV init` vs `systemd`

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

```bash
ps -p 1
```

## 通过`SysV init`启动Elasticsearch

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

```bash
sudo chkconfig --add elasticsearch
```

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

```bash
sudo -i service elasticsearch start
sudo -i service elasticsearch stop
```

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

## 通过`systemd`启动Elasticsearch

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

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

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

```bash
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`:

```bash
sudo journalctl -f
```

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

```bash
sudo journalctl --unit elasticsearch
```

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

```bash
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`端口：

```javascript
GET /
```

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

```javascript
{
  "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配置](/elasticsearch-reference/setup_elasticsearch/configuring_elasticsearch.md)。

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内核文件](https://github.com/torvalds/linux/blob/master/Documentation/sysctl/vm.txt)查看相关的`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`文件。更多信息请参见：[系统设置](/elasticsearch-reference/setup_elasticsearch/important_system_configuration/configuring_system_settings.md#systemd)。

## 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-reference/setup_elasticsearch/configuring_elasticsearch.md)。
* 配置[重要的Elasticsearch设置](/elasticsearch-reference/setup_elasticsearch/important_elasticsearch_configuration.md)。
* 配置[重要的系统设置](/elasticsearch-reference/setup_elasticsearch/important_system_configuration.md)。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://aqlu.gitbook.io/elasticsearch-reference/setup_elasticsearch/installing_elasticsearch/install_elasticsearch_with_rpm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.