Skip to content

Commit

Permalink
Add multiple data paths deprecation to docs
Browse files Browse the repository at this point in the history
This commit adds a deprecation note to the multiple data paths doc. It also removes mention of multiple paths support in the setup settings table.

relates elastic#71205
  • Loading branch information
rjernst committed Apr 5, 2021
1 parent d3c56e6 commit bca5cb8
Show file tree
Hide file tree
Showing 6 changed files with 11 additions and 7 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,18 @@ include::{es-repo-dir}/tab-widgets/code.asciidoc[]

include::{es-repo-dir}/tab-widgets/customize-data-log-path-widget.asciidoc[]

[discrete]
==== Multiple data paths
deprecated::[7.13.0]

If needed, you can specify multiple paths in `path.data`. {es} stores the node's
data across all provided paths but keeps each shard's data on the same path.

WARNING: {es} does not balance shards across a node's data paths. High disk
{es} does not balance shards across a node's data paths. High disk
usage in a single path can trigger a <<disk-based-shard-allocation,high disk
usage watermark>> for the entire node. If triggered, {es} will not add shards to
the node, even if the node’s other paths have available disk space. If you need
additional disk space, we recommend you add a new node rather than additional
data paths.
data paths.

include::{es-repo-dir}/tab-widgets/multi-data-path-widget.asciidoc[]
2 changes: 1 addition & 1 deletion docs/reference/setup/install/brew.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ and data directory are stored in the following locations.

| data
| The location of the data files of each index / shard allocated
on the node. Can hold multiple locations.
on the node.
| /usr/local/var/lib/elasticsearch
| path.data

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/setup/install/deb.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -192,7 +192,7 @@ locations for a Debian-based system:

| data
| The location of the data files of each index / shard allocated
on the node. Can hold multiple locations.
on the node.
| /var/lib/elasticsearch
| path.data

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/setup/install/rpm.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -185,7 +185,7 @@ locations for an RPM-based system:

| data
| The location of the data files of each index / shard allocated
on the node. Can hold multiple locations.
on the node.
| /var/lib/elasticsearch
| path.data

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/setup/install/targz.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ directory so that you do not delete important data later on.

| data
| The location of the data files of each index / shard allocated
on the node. Can hold multiple locations.
on the node.
| $ES_HOME/data
| path.data

Expand Down
2 changes: 1 addition & 1 deletion docs/reference/setup/install/zip-windows.asciidoc
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@ directory so that you do not delete important data later on.

| data
| The location of the data files of each index / shard allocated
on the node. Can hold multiple locations.
on the node.
| %ES_HOME%\data
| path.data

Expand Down

0 comments on commit bca5cb8

Please sign in to comment.