maverick/docbrown
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update ES docs for min/max versions and macOS brew (#6441)

Browse source 
* Update ES docs for min/max versions and macOS brew

* Clarify why we need to install the non default version
This commit is contained in:
rhymes 2020-03-04 14:28:12 +01:00 • committed by GitHub
parent ce972fb4f2
commit d95d78671f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 28 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
docs/installation/linux.md
View file

@ -66,11 +66,18 @@ We recommend following Digital Ocean's extensive
### Elasticsearch
DEV requires Elasticsearch version 7 or higher.
DEV requires a version of Elasticsearch between 7.1 and 7.5. Version 7.6 is not
supported. We recommend version 7.5.2.
We recommend following
[Elasticsearch's guide for installing on Linux](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/targz.html#install-linux).
NOTE: Make sure to download the OSS version, `elasticsearch-oss`.
Elasticsearch is also available as as
[Debian package](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/deb.html)
or a
[RPM package](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/rpm.html).
NOTE: Make sure to download **the OSS version**, `elasticsearch-oss`.
## Installing DEV

25
docs/installation/mac.md
View file

@ -59,7 +59,8 @@ redis-cli ping
### Elasticsearch
DEV requires Elasticsearch version 7 or higher.
DEV requires a version of Elasticsearch between 7.1 and 7.5. Version 7.6 is not
supported. We recommend version 7.5.2.
You have the option of installing Elasticsearch with Homebrew or through an
archive. We recommend installing from archive on Mac.
@ -96,17 +97,19 @@ To start elasticsearch as a daemonized process:
### Installing Elasticsearch with Homebrew
The following directions were
[taken from the Elasticsearch docs](https://www.elastic.co/guide/en/elasticsearch/reference/current/brew.html).
As the default version of the Homebrew formula points to Elasticsearch 7.6, we
need to retrieve the correct revision of the formula to make sure we install the
latest supported version: 7.5.2.
```shell
brew tap elastic/tap
brew install elastic/tap/elasticsearch-oss
brew install https://raw.githubusercontent.com/elastic/homebrew-tap/bed8bc6b03213c2c1a7df6e4b9f928e7082fae46/Formula/elasticsearch-oss.rb
brew pin elasticsearch-oss
```
After installation you can manually test if the Elasticsearch server starts by
issuing the command `elasticsearch` in the shell. You can then start the server
as a service with `brew services start elastic/tap/elasticsearch-oss`.
as a service with `brew services start elasticsearch-oss`.
You can find further info on your local Elasticsearch installation by typing
`brew info elastic/tap/elasticsearch-oss`.
@ -122,8 +125,8 @@ Exception in thread "main" org.elasticsearch.bootstrap.BootstrapException: java.
Likely root cause: java.nio.file.FileSystemLoopException: /usr/local/etc/elasticsearch/elasticsearch
```
This happens because the installation of Elasticsearch might have a recursive link in the
configuration directory causing the infinite loop:
This happens because the installation of Elasticsearch might have a recursive
link in the configuration directory causing the infinite loop:
```shell
> ll /usr/local/etc/elasticsearch
@ -169,13 +172,13 @@ your local Elasticsearch installation, for example:
"cluster_name": "elasticsearch_...",
"cluster_uuid": "...",
"version": {
"number": "7.6.0",
"number": "7.5.2",
"build_flavor": "oss",
"build_type": "tar",
"build_hash": "7f634e9f44834fbc12724506cc1da681b0c3b1e3",
"build_date": "2020-02-06T00:09:00.449973Z",
"build_hash": "8bec50e1e0ad29dad5653712cf3bb580cd1afcdf",
"build_date": "2020-01-15T12:11:52.313576Z",
"build_snapshot": false,
"lucene_version": "8.4.0",
"lucene_version": "8.3.0",
"minimum_wire_compatibility_version": "6.8.0",
"minimum_index_compatibility_version": "6.0.0-beta1"
},

8
docs/installation/windows.md
View file

@ -142,12 +142,14 @@ WSL.
### Elasticsearch
DEV requires Elasticsearch version 7 or higher.
DEV requires a version of Elasticsearch between 7.1 and 7.5. Version 7.6 is not
supported. We recommend version 7.5.2.
We recommend following the install guide
[in Elasticsearch's docs](https://www.elastic.co/guide/en/elasticsearch/reference/7.5/zip-windows.html)
for installing on Windows machines. NOTE: Make sure to download the OSS version,
`elasticsearch-oss`.
for installing on Windows machines.
NOTE: Make sure to download **the OSS version**, `elasticsearch-oss`.
## Installing DEV