RPM安装方式 · my-elasticsearch-cn

# RPM安装方式 Elasticsearch的RPM软件包可以从[我们的网站下载](#install-rpm)或从[我们的APT仓库](#rpm-repo)安装。它可以用于任何基于RPM的系统上安装Elasticsearch，如OpenSuse、SLES、Centos、Red Hat与企业级Oracle。 > 注意 > > RPM包不支持老的RPM平台，譬如SLES 11与CentOS 5，这些平台请采用[.zip或.tar.gz文件的安装方式](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/)）： ``` 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-6.x] name=Elasticsearch repository for 6.x packages baseurl=https://artifacts.elastic.co/packages/6.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的6.0.0版本RPM安装包可以通过如下指令从网站下载与安装： ``` wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.0.0.rpm wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-6.0.0.rpm.sha512 shasum -a 512 -c elasticsearch-6.0.0.rpm.sha512 ① sudo rpm --install elasticsearch-6.0.0.rpm ``` ① Compares the SHA of the downloaded RPM and the published checksum, which should output `elasticsearch-{version}.rpm: OK`. > 注意 > > On systemd-based distributions, the installation scripts will attempt to set kernel parameters (e.g., `vm.max_map_count`); you can skip this by masking the systemd-sysctl.service unit. ## `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" : "6.0.0", "build_hash" : "f27399d", "build_date" : "2016-03-30T09:51:41.449Z", "build_snapshot" : false, "lucene_version" : "7.0.1", "minimum_wire_compatibility_version" : "1.2.3", "minimum_index_compatibility_version" : "1.2.3" }, "tagline" : "You Know, for Search" } ``` ## 配置Elasticsearch Elasticsearch defaults to using `/etc/elasticsearch` for runtime configuration. The ownership of this directory and all files in this directory are set to`root:elasticsearch` on package installation and the directory has the `setgid` flag set so that any files and subdirectories created under `/etc/elasticsearch` are created with this ownership as well (e.g., if a keystore is created using the[keystore tool](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/secure-settings.html "Secure Settings")). It is expected that this be maintained so that the Elasticsearch process can read the files under this directory via the group permissions. Elasticsearch loads its configuration from the`/etc/elasticsearch/elasticsearch.yml` file by default. The format of this config file is explained in [*Configuring Elasticsearch*](https://www.elastic.co/guide/en/elasticsearch/reference/6.0/settings.html "Configuring Elasticsearch"). RPM软件包也有一个系统配置文件（`/etc/sysconfig/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。 * ES_PATH_CONF配置文件目录（其中必须包括`elasticsearch.yml`和`log4j2.properties`文件），默认为`/etc/elasticsearch`。 * ES\_JAVA\_OPTS任何额外的JVM系统属性，你可能要应用。 * RESTART\_ON\_UPGRADE配置在安装包升级后重启，默认为`false`。这意味着你将在安装包后需要手动重新启动您的elasticsearch实例。这样做的原因是为了保证，在群集升级时不会连续的重新分配分片导致高网络流量、并降低群集的响应时间。 > 注意 > > 使用systemd部署需要配置`systemd`的系统资源限制，而不是通过`/etc/sysconfig/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 * logs 日志文件的位置。/var/log/elasticsearchpath.logs * plugins 插件的位置。每一个插件将被包含在一个子目录。/usr/share/elasticsearch/plugins * repo 共享文件系统存储库位置。可以容纳多个位置。文件系统存储库可以放在这里指定的任意目录中的任何子目录。未配置path.repo ## 下一步现在，您搭建了一个测试环境Elasticsearch。开始更深入的研究或投入生产使用Elasticsearch之前，你需要做一些额外的配置： - 了解如何[配置Elasticsearch](../Configuring_Elasticsearch.md)。 - 配置[重要的Elasticsearch设置](../Important_Elasticsearch_configuration.md)。 - 配置[重要的系统设置](../Important_System_Configuration.md)。 > my note > > `/etc/sysconfig/elasticsearch` 文件的配置 > journalctl 查看日志 > 注意elasticsearch的目录权限