OpenSearch/docs/reference/setup/dir-layout.asciidoc

100 lines
4.1 KiB
Plaintext

[[setup-dir-layout]]
== Directory Layout
The directory layout of an installation is as follows:
[cols="<h,<,<m,<m",options="header",]
|=======================================================================
| Type | Description | Default Location | Setting
| home | Home of elasticsearch installation. | | path.home
| bin | Binary scripts including `elasticsearch` to start a node. | {path.home}/bin | | conf | Configuration files including `elasticsearch.yml` | {path.home}/config | path.conf
| data | The location of the data files of each index / shard allocated
on the node. Can hold multiple locations. | {path.home}/data| path.data
| logs | Log files location. | {path.home}/logs | path.logs
| plugins | Plugin files location. Each plugin will be contained in a subdirectory. | {path.home}/plugins | path.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
| script | Location of script files. | {path.conf}/scripts | path.script
|=======================================================================
Multiple `data` paths may be specified, in order to spread data across
multiple disks or locations, but all of the files from a single shard will be
written to the same path. This can be configured as follows:
---------------------------------
path.data: /mnt/first,/mnt/second
---------------------------------
Or in an array format:
----------------------------------------
path.data: ["/mnt/first", "/mnt/second"]
----------------------------------------
TIP: To stripe shards across multiple disks, please use a RAID driver
instead.
[float]
[[default-paths]]
=== Default Paths
Below are the default paths that elasticsearch will use, if not explicitly changed.
[float]
==== deb and rpm
[cols="<h,<,<m,<m",options="header",]
|=======================================================================
| Type | Description | Location Debian/Ubuntu | Location RHEL/CentOS
| home | Home of elasticsearch installation. | /usr/share/elasticsearch | /usr/share/elasticsearch
| bin | Binary scripts including `elasticsearch` to start a node. | /usr/share/elasticsearch/bin | /usr/share/elasticsearch/bin
| conf | Configuration files `elasticsearch.yml` and `logging.yml`. | /etc/elasticsearch | /etc/elasticsearch
| conf | Environment variables including heap size, file descriptors. | /etc/default/elasticseach | /etc/sysconfig/elasticsearch
| data | The location of the data files of each index / shard allocated
on the node. | /var/lib/elasticsearch/data | /var/lib/elasticsearch
| logs | Log files location | /var/log/elasticsearch | /var/log/elasticsearch
| plugins | Plugin files location. Each plugin will be contained in a subdirectory. | /usr/share/elasticsearch/plugins | /usr/share/elasticsearch/plugins
| repo | Shared file system repository locations. d| Not configured d| Not configured
| script | Location of script files. | /etc/elasticsearch/scripts | /etc/elasticsearch/scripts
|=======================================================================
[float]
==== zip and tar.gz
[cols="<h,<,<m",options="header",]
|=======================================================================
| Type | Description | Location
| home | Home of elasticsearch installation | {extract.path}
| bin | Binary scripts including `elasticsearch` to start a node | {extract.path}/bin
| conf | Configuration files `elasticsearch.yml` and `logging.yml` | {extract.path}/config
| conf | Environment variables including heap size, file descriptors | {extract.path}/config
| data | The location of the data files of each index / shard allocated
on the node | {extract.path}/data
| logs | Log files location | {extract.path}/logs
| plugins | Plugin files location. Each plugin will be contained in a subdirectory | {extract.path}/plugins
| repo | Shared file system repository locations. d| Not configured
| script | Location of script files. | {extract.path}/config/scripts
|=======================================================================