mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-06 04:58:50 +00:00
18a3e48a4a
Some systems default to a nofile ulimit of 65535. To reduce the pain of deploying Elasticsearch to such systems, this commit lowers the required limit from 65536 to 65535.
110 lines
3.4 KiB
Plaintext
110 lines
3.4 KiB
Plaintext
[[setting-system-settings]]
|
|
=== Configuring system settings
|
|
|
|
Where to configure systems settings depends on which package you have used to
|
|
install Elasticsearch, and which operating system you are using.
|
|
|
|
When using the `.zip` or `.tar.gz` packages, system settings can be configured:
|
|
|
|
* temporarily with <<ulimit,`ulimit`>>, or
|
|
* permanently in <<limits.conf,`/etc/security/limits.conf`>>.
|
|
|
|
When using the RPM or Debian packages, most system settings are set in the
|
|
<<sysconfig,system configuration file>>. However, systems which use systemd
|
|
require that system limits are specified in a
|
|
<<systemd,systemd configuration file>>.
|
|
|
|
[[ulimit]]
|
|
==== `ulimit`
|
|
|
|
On Linux systems, `ulimit` can be used to change resource limits on a
|
|
temporary basis. Limits usually need to be set as `root` before switching to
|
|
the user that will run Elasticsearch. For example, to set the number of
|
|
open file handles (`ulimit -n`) to 65,536, you can do the following:
|
|
|
|
[source,sh]
|
|
--------------------------------
|
|
sudo su <1>
|
|
ulimit -n 65535 <2>
|
|
su elasticsearch <3>
|
|
--------------------------------
|
|
<1> Become `root`.
|
|
<2> Change the max number of open files.
|
|
<3> Become the `elasticsearch` user in order to start Elasticsearch.
|
|
|
|
The new limit is only applied during the current session.
|
|
|
|
You can consult all currently applied limits with `ulimit -a`.
|
|
|
|
[[limits.conf]]
|
|
==== `/etc/security/limits.conf`
|
|
|
|
On Linux systems, persistent limits can be set for a particular user by
|
|
editing the `/etc/security/limits.conf` file. To set the maximum number of
|
|
open files for the `elasticsearch` user to 65,536, add the following line to
|
|
the `limits.conf` file:
|
|
|
|
[source,sh]
|
|
--------------------------------
|
|
elasticsearch - nofile 65535
|
|
--------------------------------
|
|
|
|
This change will only take effect the next time the `elasticsearch` user opens
|
|
a new session.
|
|
|
|
[NOTE]
|
|
.Ubuntu and `limits.conf`
|
|
===============================
|
|
Ubuntu ignores the `limits.conf` file for processes started by `init.d`. To
|
|
enable the `limits.conf` file, edit `/etc/pam.d/su` and uncomment the
|
|
following line:
|
|
|
|
[source,sh]
|
|
--------------------------------
|
|
# session required pam_limits.so
|
|
--------------------------------
|
|
===============================
|
|
|
|
[[sysconfig]]
|
|
==== Sysconfig file
|
|
|
|
When using the RPM or Debian packages, system settings and environment
|
|
variables can be specified in the system configuration file, which is located
|
|
in:
|
|
|
|
[horizontal]
|
|
RPM:: `/etc/sysconfig/elasticsearch`
|
|
Debian:: `/etc/default/elasticsearch`
|
|
|
|
However, for systems which uses `systemd`, system limits need to be specified
|
|
via <<systemd,systemd>>.
|
|
|
|
[[systemd]]
|
|
==== Systemd configuration
|
|
|
|
When using the RPM or Debian packages on systems that use
|
|
https://en.wikipedia.org/wiki/Systemd[systemd], system limits must be
|
|
specified via systemd.
|
|
|
|
The systemd service file (`/usr/lib/systemd/system/elasticsearch.service`)
|
|
contains the limits that are applied by default.
|
|
|
|
To override them, add a file called
|
|
`/etc/systemd/system/elasticsearch.service.d/override.conf` (alternatively,
|
|
you may run `sudo systemctl edit elasticsearch` which opens the file
|
|
automatically inside your default editor). Set any changes in this file,
|
|
such as:
|
|
|
|
[source,sh]
|
|
---------------------------------
|
|
[Service]
|
|
LimitMEMLOCK=infinity
|
|
---------------------------------
|
|
|
|
Once finished, run the following command to reload units:
|
|
|
|
[source,sh]
|
|
---------------------------------
|
|
sudo systemctl daemon-reload
|
|
---------------------------------
|