mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-30 02:13:33 -04:00
3e019a4d56
If another service, such as an antivirus or backup program, opens and locks files in the `path.data` directory, Elasticsearch may return errors.
28 lines
1.2 KiB
Text
28 lines
1.2 KiB
Text
[[path-settings]]
|
|
[discrete]
|
|
==== Path settings
|
|
|
|
{es} writes the data you index to indices and data streams to a `data`
|
|
directory. {es} writes its own application logs, which contain information about
|
|
cluster health and operations, to a `logs` directory.
|
|
|
|
For <<targz,macOS `.tar.gz`>>, <<targz,Linux `.tar.gz`>>, and
|
|
<<zip-windows,Windows `.zip`>> installations, `data` and `logs` are
|
|
subdirectories of `$ES_HOME` by default. However, files in `$ES_HOME` risk
|
|
deletion during an upgrade.
|
|
|
|
In production, we strongly recommend you set the `path.data` and `path.logs` in
|
|
`elasticsearch.yml` to locations outside of `$ES_HOME`. <<docker,Docker>>,
|
|
<<deb,Debian>>, <<rpm,RPM>>, <<brew,macOS Homebrew>>, and <<windows,Windows
|
|
`.msi`>> installations write data and log to locations outside of `$ES_HOME` by
|
|
default.
|
|
|
|
IMPORTANT: To avoid errors, only {es} should open files in the `path.data`
|
|
directory. Exclude the `path.data` directory from other services that may open
|
|
and lock its files, such as antivirus or backup programs.
|
|
|
|
Supported `path.data` and `path.logs` values vary by platform:
|
|
|
|
include::{es-repo-dir}/tab-widgets/code.asciidoc[]
|
|
|
|
include::{es-repo-dir}/tab-widgets/customize-data-log-path-widget.asciidoc[]
|