mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-26 06:46:10 +00:00
The environment variable CONF_DIR was previously inconsistently used in our packaging to customize the location of Elasticsearch configuration files. The importance of this environment variable has increased starting in 6.0.0 as it's now used consistently to ensure Elasticsearch and all secondary scripts (e.g., elasticsearch-keystore) all use the same configuration. The name CONF_DIR is there for legacy reasons yet it's too generic. This commit renames CONF_DIR to ES_PATH_CONF. Relates #26197
219 lines
6.6 KiB
Plaintext
219 lines
6.6 KiB
Plaintext
[[rpm]]
|
|
=== Install Elasticsearch with RPM
|
|
|
|
The RPM for Elasticsearch can be <<install-rpm,downloaded from our website>>
|
|
or from our <<rpm-repo,RPM repository>>. It can be used to install
|
|
Elasticsearch on any RPM-based system such as OpenSuSE, SLES, Centos, Red Hat,
|
|
and Oracle Enterprise.
|
|
|
|
NOTE: RPM install is not supported on distributions with old versions of RPM,
|
|
such as SLES 11 and CentOS 5. Please see <<zip-targz>> instead.
|
|
|
|
The latest stable version of Elasticsearch can be found on the
|
|
link:/downloads/elasticsearch[Download Elasticsearch] page. Other versions can
|
|
be found on the link:/downloads/past-releases[Past Releases page].
|
|
|
|
NOTE: Elasticsearch requires Java 8 or later. Use the
|
|
http://www.oracle.com/technetwork/java/javase/downloads/index.html[official Oracle distribution]
|
|
or an open-source distribution such as http://openjdk.java.net[OpenJDK].
|
|
|
|
[[rpm-key]]
|
|
==== Import the Elasticsearch PGP Key
|
|
|
|
include::key.asciidoc[]
|
|
|
|
[source,sh]
|
|
-------------------------
|
|
rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch
|
|
-------------------------
|
|
|
|
[[rpm-repo]]
|
|
==== Installing from the RPM repository
|
|
|
|
ifeval::["{release-state}"=="unreleased"]
|
|
|
|
Version {version} of Elasticsearch has not yet been released.
|
|
|
|
endif::[]
|
|
|
|
ifeval::["{release-state}"!="unreleased"]
|
|
|
|
Create a file called `elasticsearch.repo` in the `/etc/yum.repos.d/` directory
|
|
for RedHat based distributions, or in the `/etc/zypp/repos.d/` directory for
|
|
OpenSuSE based distributions, containing:
|
|
|
|
ifeval::["{release-state}"=="released"]
|
|
|
|
["source","sh",subs="attributes,callouts"]
|
|
--------------------------------------------------
|
|
[elasticsearch-{major-version}]
|
|
name=Elasticsearch repository for {major-version} packages
|
|
baseurl=https://artifacts.elastic.co/packages/{major-version}/yum
|
|
gpgcheck=1
|
|
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
|
|
enabled=1
|
|
autorefresh=1
|
|
type=rpm-md
|
|
--------------------------------------------------
|
|
|
|
endif::[]
|
|
|
|
ifeval::["{release-state}"=="prerelease"]
|
|
|
|
["source","sh",subs="attributes,callouts"]
|
|
--------------------------------------------------
|
|
[elasticsearch-{major-version}]
|
|
name=Elasticsearch repository for {major-version} packages
|
|
baseurl=https://artifacts.elastic.co/packages/{major-version}-prerelease/yum
|
|
gpgcheck=1
|
|
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
|
|
enabled=1
|
|
autorefresh=1
|
|
type=rpm-md
|
|
--------------------------------------------------
|
|
|
|
endif::[]
|
|
|
|
And your repository is ready for use. You can now install Elasticsearch with one of the following commands:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
sudo yum install elasticsearch <1>
|
|
sudo dnf install elasticsearch <2>
|
|
sudo zypper install elasticsearch <3>
|
|
--------------------------------------------------
|
|
<1> Use `yum` on CentOS and older Red Hat based distributions.
|
|
<2> Use `dnf` on Fedora and other newer Red Hat distributions.
|
|
<3> Use `zypper` on OpenSUSE based distributions
|
|
|
|
endif::[]
|
|
|
|
[[install-rpm]]
|
|
==== Download and install the RPM manually
|
|
|
|
ifeval::["{release-state}"=="unreleased"]
|
|
|
|
Version {version} of Elasticsearch has not yet been released.
|
|
|
|
endif::[]
|
|
|
|
ifeval::["{release-state}"!="unreleased"]
|
|
|
|
The RPM for Elasticsearch v{version} can be downloaded from the website and installed as follows:
|
|
|
|
["source","sh",subs="attributes"]
|
|
--------------------------------------------
|
|
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{version}.rpm
|
|
sha1sum elasticsearch-{version}.rpm <1>
|
|
sudo rpm --install elasticsearch-{version}.rpm
|
|
--------------------------------------------
|
|
<1> Compare the SHA produced by `sha1sum` or `shasum` with the
|
|
https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{version}.rpm.sha1[published SHA].
|
|
|
|
endif::[]
|
|
|
|
include::skip-set-kernel-parameters.asciidoc[]
|
|
|
|
include::init-systemd.asciidoc[]
|
|
|
|
[[rpm-running-init]]
|
|
==== Running Elasticsearch with SysV `init`
|
|
|
|
Use the `chkconfig` command to configure Elasticsearch to start automatically
|
|
when the system boots up:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
sudo chkconfig --add elasticsearch
|
|
--------------------------------------------------
|
|
|
|
Elasticsearch can be started and stopped using the `service` command:
|
|
|
|
[source,sh]
|
|
--------------------------------------------
|
|
sudo -i service elasticsearch start
|
|
sudo -i service elasticsearch stop
|
|
--------------------------------------------
|
|
|
|
If Elasticsearch fails to start for any reason, it will print the reason for
|
|
failure to STDOUT. Log files can be found in `/var/log/elasticsearch/`.
|
|
|
|
|
|
[[rpm-running-systemd]]
|
|
include::systemd.asciidoc[]
|
|
|
|
[[rpm-check-running]]
|
|
include::check-running.asciidoc[]
|
|
|
|
[[rpm-configuring]]
|
|
==== Configuring Elasticsearch
|
|
|
|
Elasticsearch loads its configuration from the `/etc/elasticsearch/elasticsearch.yml`
|
|
file by default. The format of this config file is explained in
|
|
<<settings>>.
|
|
|
|
The RPM also has a system configuration file (`/etc/sysconfig/elasticsearch`),
|
|
which allows you to set the following parameters:
|
|
|
|
include::sysconfig-file.asciidoc[]
|
|
|
|
NOTE: Distributions that use `systemd` require that system resource limits be
|
|
configured via `systemd` rather than via the `/etc/sysconfig/elasticsearch`
|
|
file. See <<systemd>> for more information.
|
|
|
|
[[rpm-layout]]
|
|
==== Directory layout of RPM
|
|
|
|
The RPM places config files, logs, and the data directory in the appropriate
|
|
locations for an RPM-based system:
|
|
|
|
|
|
[cols="<h,<,<m,<m",options="header",]
|
|
|=======================================================================
|
|
| Type | Description | Default Location | Setting
|
|
| home
|
|
| Elasticsearch home directory or `$ES_HOME`
|
|
| /usr/share/elasticsearch
|
|
d|
|
|
|
|
| bin
|
|
| Binary scripts including `elasticsearch` to start a node
|
|
and `elasticsearch-plugin` to install plugins
|
|
| /usr/share/elasticsearch/bin
|
|
d|
|
|
|
|
| conf
|
|
| Configuration files including `elasticsearch.yml`
|
|
| /etc/elasticsearch
|
|
| <<config-files-location,ES_PATH_CONF>>
|
|
|
|
| conf
|
|
| Environment variables including heap size, file descriptors.
|
|
| /etc/sysconfig/elasticsearch
|
|
d|
|
|
|
|
| data
|
|
| The location of the data files of each index / shard allocated
|
|
on the node. Can hold multiple locations.
|
|
| /var/lib/elasticsearch
|
|
| path.data
|
|
|
|
| logs
|
|
| Log files location.
|
|
| /var/log/elasticsearch
|
|
| path.logs
|
|
|
|
| plugins
|
|
| Plugin files location. Each plugin will be contained in a subdirectory.
|
|
| /usr/share/elasticsearch/plugins
|
|
|
|
|
|
|
| repo
|
|
| Shared file system repository locations. Can hold multiple locations. A file system repository can be placed in to any subdirectory of any directory specified here.
|
|
d| Not configured
|
|
| path.repo
|
|
|
|
|=======================================================================
|
|
|
|
include::next-steps.asciidoc[]
|