Elasticsearch Install Script

This script can be used to install Elasticsearch as well as Elasticsearch plugins.

This script has been tested on the following operating systems:

There is a good chance it will work on other flavors of Debian, CentOS, and RHEL as well.

Quick start

This module depends on bash-commons, so you must install that project first as documented in its README.

The easiest way to use this module is with the Gruntwork Installer:

gruntwork-install \
  --module-name "install-elasticsearch" \
  --repo "https://github.com/gruntwork-io/terraform-aws-elk" \
  --tag "<VERSION>"

Checkout the releases to find the latest version.

We recommend running the install-elasticsearch script as part of a Packer template to create an Elasticsearch Amazon Machine Image (AMI) (see the elasticsearch-ami example for fully-working sample code). You can then deploy the AMI across an Auto Scaling Group using the elasticsearch-cluster module (see the examples folder for fully-working sample code).

Run install-elasticsearch --help to see all available arguments.

Param	Description	Default
`--version`	The version of Elasticsearch to install	6.8.21
`--config-file`	Optional path to a templated Elasticsearcg config file (elasticsearch.yml).	/tmp/config/elasticsearch.yml
`--jvm-config-file`	Optional path to a templated JVM config file (jvm.options)	/tmp/config/jvm.options
`--plugin`	Optional name of Elasticsearch plugin to install. Can also specify absolute path like: "file:///tmp/plugin-X.Y.Z.zip". May be repeated
`--plugin-config-dir`	Optional path to folder containing any extra plugin config files. All files from this folder will be moved to: /etc/elasticsearch

The install-elasticsearch script:

Installs Elasticsearch using the package manager for your OS (eg: apt or yum)
Optionally installs any plugins specified with the --plugin parameter.
TODO: ()The script doesn't actually do this yet!) Optimizes the system configuration for maximum Elasticsearch performance per official recommendations.