|
|
@@ -1,9 +1,12 @@
|
|
|
[[windows]]
|
|
|
-=== Install Elasticsearch on Windows
|
|
|
+=== Install Elasticsearch with MSI Windows Installer
|
|
|
|
|
|
-Elasticsearch can be installed on Windows using the `.zip` package. This
|
|
|
-comes with a `elasticsearch-service.bat` command which will setup Elasticsearch to run as a
|
|
|
-service.
|
|
|
+Elasticsearch can be installed on Windows using the `.msi` package. This can
|
|
|
+install Elasticsearch as a Windows service or allow it to be run manually using
|
|
|
+the included `elasticsearch.exe` executable.
|
|
|
+
|
|
|
+TIP: Elasticsearch has historically been installed on Windows using the <<zip-windows, .zip>> archive.
|
|
|
+You can continue using the `.zip` approach if you prefer.
|
|
|
|
|
|
The latest stable version of Elasticsearch can be found on the
|
|
|
link:/downloads/elasticsearch[Download Elasticsearch] page.
|
|
|
@@ -14,8 +17,8 @@ NOTE: Elasticsearch requires Java 8 or later. Use the
|
|
|
http://www.oracle.com/technetwork/java/javase/downloads/index.html[official Oracle distribution]
|
|
|
or an open-source distribution such as http://openjdk.java.net[OpenJDK].
|
|
|
|
|
|
-[[install-windows]]
|
|
|
-==== Download and install the `.zip` package
|
|
|
+[[download-msi]]
|
|
|
+==== Download the `.msi` package
|
|
|
|
|
|
ifeval::["{release-state}"=="unreleased"]
|
|
|
|
|
|
@@ -25,236 +28,392 @@ endif::[]
|
|
|
|
|
|
ifeval::["{release-state}"!="unreleased"]
|
|
|
|
|
|
-Download the `.zip` archive for Elasticsearch v{version} from: https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{version}.zip
|
|
|
+Download the `.msi` package for Elasticsearch v{version} from https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-{version}.msi
|
|
|
|
|
|
-Unzip it with your favourite unzip tool. This will create a folder called
|
|
|
-+elasticsearch-{version}+, which we will refer to as `%ES_HOME%`. In a terminal
|
|
|
-window, `cd` to the `%ES_HOME%` directory, for instance:
|
|
|
+endif::[]
|
|
|
|
|
|
-["source","sh",subs="attributes"]
|
|
|
-----------------------------
|
|
|
-cd c:\elasticsearch-{version}
|
|
|
-----------------------------
|
|
|
+[[install-msi-gui]]
|
|
|
+==== Install using the graphical user interface (GUI)
|
|
|
|
|
|
-endif::[]
|
|
|
+Double-click the downloaded `.msi` package to launch a GUI wizard that will guide you through the
|
|
|
+installation process. You can view help on any step by clicking the `?` button, which reveals an
|
|
|
+aside panel with additional information for each input:
|
|
|
|
|
|
-[[windows-running]]
|
|
|
-==== Running Elasticsearch from the command line
|
|
|
+[[msi-installer-help]]
|
|
|
+image::images/msi_installer/msi_installer_help.png[]
|
|
|
|
|
|
-Elasticsearch can be started from the command line as follows:
|
|
|
+Within the first screen, select the directory for the installation. In addition, select directories for where
|
|
|
+data, logs and configuration will reside or <<msi-command-line-options,roll with the default locations>>:
|
|
|
|
|
|
-[source,sh]
|
|
|
---------------------------------------------
|
|
|
-.\bin\elasticsearch.bat
|
|
|
---------------------------------------------
|
|
|
+[[msi-installer-locations]]
|
|
|
+image::images/msi_installer/msi_installer_locations.png[]
|
|
|
|
|
|
-By default, Elasticsearch runs in the foreground, prints its logs to `STDOUT`,
|
|
|
-and can be stopped by pressing `Ctrl-C`.
|
|
|
+Then select whether to install as a service or start Elasticsearch manually as needed. When
|
|
|
+installing as a service, you can also decide which account to run the service under as well
|
|
|
+as whether the service should be started after installation and when Windows is started or
|
|
|
+restarted:
|
|
|
|
|
|
-[[windows-configuring]]
|
|
|
-==== Configuring Elasticsearch on the command line
|
|
|
+[[msi-installer-service]]
|
|
|
+image::images/msi_installer/msi_installer_service.png[]
|
|
|
|
|
|
-Elasticsearch loads its configuration from the `%ES_HOME%\config\elasticsearch.yml`
|
|
|
-file by default. The format of this config file is explained in
|
|
|
-<<settings>>.
|
|
|
+IMPORTANT: When selecting an account to run the service with, be sure that the chosen account
|
|
|
+has sufficient privileges to access the installation and other deployment directories chosen.
|
|
|
|
|
|
-Any settings that can be specified in the config file can also be specified on
|
|
|
-the command line, using the `-E` syntax as follows:
|
|
|
+Common configuration settings are exposed within the Configuration section, allowing the cluster
|
|
|
+name, node name and roles to be set, in addition to memory and network settings:
|
|
|
|
|
|
-[source,sh]
|
|
|
+[[msi-installer-configuration]]
|
|
|
+image::images/msi_installer/msi_installer_configuration.png[]
|
|
|
+
|
|
|
+Finally, the installer provides a list of common plugins that can be downloaded and installed as
|
|
|
+part of the installation:
|
|
|
+
|
|
|
+[[msi-installer-selected-plugins]]
|
|
|
+image::images/msi_installer/msi_installer_selected_plugins.png[]
|
|
|
+
|
|
|
+By default, the {xpack-ref}/index.html[X-Pack] plugin will be selected to be installed, and if
|
|
|
+installing with the <<ingest, ingest>> node role, the {plugins}/ingest-attachment.html[Ingest Attachment Processor] and {plugins}/ingest-geoip.html[Ingest GeoIP Processor] plugins will also be selected for installation.
|
|
|
+
|
|
|
+NOTE: X-Pack includes a trial license for 30 days. After that, you can obtain one of the https://www.elastic.co/subscriptions[available subscriptions] or {xpack-ref}/security-settings.html[disable Security]. The Basic license is free and includes the https://www.elastic.co/products/x-pack/monitoring[Monitoring] extension.
|
|
|
+
|
|
|
+After clicking the install button, Elasticsearch will be installed:
|
|
|
+
|
|
|
+[[msi-installer-success]]
|
|
|
+image::images/msi_installer/msi_installer_success.png[]
|
|
|
+
|
|
|
+[[install-msi-command-line]]
|
|
|
+==== Install using the command line
|
|
|
+
|
|
|
+The `.msi` can also install Elasticsearch using the command line. The simplest installation
|
|
|
+using the same defaults as the GUI is achieved by first navigating to the download directory,
|
|
|
+then running:
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
--------------------------------------------
|
|
|
-.\bin\elasticsearch.bat -Ecluster.name=my_cluster -Enode.name=node_1
|
|
|
+msiexec.exe /i elasticsearch-{version}.msi /qn
|
|
|
--------------------------------------------
|
|
|
|
|
|
-NOTE: Values that contain spaces must be surrounded with quotes. For instance `-Epath.logs="C:\My Logs\logs"`.
|
|
|
+By default, msiexec does not wait for the installation process to complete, since it runs in the
|
|
|
+Windows subsystem. To wait on the process to finish and ensure that `%ERRORLEVEL%` is set
|
|
|
+accordingly, it is recommended to use `start /wait` to create a process and wait for it to exit
|
|
|
|
|
|
-TIP: Typically, any cluster-wide settings (like `cluster.name`) should be
|
|
|
-added to the `elasticsearch.yml` config file, while any node-specific settings
|
|
|
-such as `node.name` could be specified on the command line.
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /i elasticsearch-{version}.msi /qn
|
|
|
+--------------------------------------------
|
|
|
|
|
|
-include::check-running.asciidoc[]
|
|
|
+As with any MSI installation package, a log file for the installation process can be found
|
|
|
+within the `%TEMP%` directory, with a randomly generated name adhering to the format
|
|
|
+`MSI*.LOG`. The path to a log file can be supplied using the `/l` command line argument
|
|
|
|
|
|
-[[windows-service]]
|
|
|
-==== Installing Elasticsearch as a Service on Windows
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /i elasticsearch-{version}.msi /qn /l install.log
|
|
|
+--------------------------------------------
|
|
|
|
|
|
-Elasticsearch can be installed as a service to run in the background or start
|
|
|
-automatically at boot time without any user interaction. This can be achieved
|
|
|
-through the `elasticsearch-service.bat` script in the `bin\` folder which allows one to
|
|
|
-install, remove, manage or configure the service and potentially start and
|
|
|
-stop the service, all from the command-line.
|
|
|
+Supported Windows Installer command line arguments can be viewed using
|
|
|
|
|
|
["source","sh",subs="attributes,callouts"]
|
|
|
---------------------------------------------------
|
|
|
-c:\elasticsearch-{version}{backslash}bin>elasticsearch-service
|
|
|
+--------------------------------------------
|
|
|
+msiexec.exe /help
|
|
|
+--------------------------------------------
|
|
|
|
|
|
-Usage: elasticsearch-service.bat install|remove|start|stop|manager [SERVICE_ID]
|
|
|
---------------------------------------------------
|
|
|
+or by consulting the https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988(v=vs.85).aspx[Windows Installer SDK Command-Line Options].
|
|
|
|
|
|
-The script requires one parameter (the command to execute) followed by an
|
|
|
-optional one indicating the service id (useful when installing multiple
|
|
|
-Elasticsearch services).
|
|
|
+[[msi-command-line-options]]
|
|
|
+==== Command line options
|
|
|
|
|
|
-The commands available are:
|
|
|
+All settings exposed within the GUI are also available as command line arguments (referred to
|
|
|
+as _properties_ within Windows Installer documentation) that can be passed to msiexec:
|
|
|
|
|
|
[horizontal]
|
|
|
-`install`:: Install Elasticsearch as a service
|
|
|
+`INSTALLDIR`::
|
|
|
|
|
|
-`remove`:: Remove the installed Elasticsearch service (and stop the service if started)
|
|
|
+ The installation directory. Defaults to `%PROGRAMFILES%\Elastic\Elasticsearch`
|
|
|
|
|
|
-`start`:: Start the Elasticsearch service (if installed)
|
|
|
+`DATADIRECTORY`::
|
|
|
|
|
|
-`stop`:: Stop the Elasticsearch service (if started)
|
|
|
+ The directory in which to store your data.
|
|
|
+Defaults to `%ALLUSERSPROFILE%\Elastic\Elasticsearch\data`
|
|
|
|
|
|
-`manager`:: Start a GUI for managing the installed service
|
|
|
+`CONFIGDIRECTORY`::
|
|
|
|
|
|
-Based on the architecture of the available JDK/JRE (set through `JAVA_HOME`),
|
|
|
-the appropriate 64-bit(x64) or 32-bit(x86) service will be installed. This
|
|
|
-information is made available during install:
|
|
|
+ The directory in which to store your configuration.
|
|
|
+ Defaults to `%ALLUSERSPROFILE%\Elastic\Elasticsearch\config`
|
|
|
|
|
|
-["source","sh",subs="attributes"]
|
|
|
---------------------------------------------------
|
|
|
-c:\elasticsearch-{version}{backslash}bin>elasticsearch-service install
|
|
|
-Installing service : "elasticsearch-service-x64"
|
|
|
-Using JAVA_HOME (64-bit): "c:\jvm\jdk1.8"
|
|
|
-The service 'elasticsearch-service-x64' has been installed.
|
|
|
---------------------------------------------------
|
|
|
+`LOGSDIRECTORY`::
|
|
|
|
|
|
-NOTE: While a JRE can be used for the Elasticsearch service, due to its use of a client VM (as opposed to a server JVM which offers better performance for long-running applications) its usage is discouraged and a warning will be issued.
|
|
|
+ The directory in which to store your logs.
|
|
|
+ Defaults to `%ALLUSERSPROFILE%\Elastic\Elasticsearch\logs`
|
|
|
|
|
|
-NOTE: The system environment variable `JAVA_HOME` should be set to the path to
|
|
|
-the JDK installation that you want the service to use. If you upgrade the JDK,
|
|
|
-you are not required to the reinstall the service but you must set the value of
|
|
|
-the system environment variable `JAVA_HOME` to the path to the new JDK
|
|
|
-installation. However, upgrading across JVM types (e.g. JRE versus SE) is not
|
|
|
-supported, and does require the service to be reinstalled.
|
|
|
+`PLACEWRITABLELOCATIONSINSAMEPATH`::
|
|
|
|
|
|
-[[windows-service-settings]]
|
|
|
-[float]
|
|
|
-=== Customizing service settings
|
|
|
+ Whether the data, configuration and logs directories
|
|
|
+ should be created under the installation directory. Defaults to `false`
|
|
|
|
|
|
-The Elasticsearch service can be configured prior to installation by setting the following environment variables (either using the https://technet.microsoft.com/en-us/library/cc754250(v=ws.10).aspx[set command] from the command line, or through the `System Properties->Environment Variables` GUI).
|
|
|
+`INSTALLASSERVICE`::
|
|
|
|
|
|
-[horizontal]
|
|
|
-`SERVICE_ID`::
|
|
|
+ Whether Elasticsearch is installed and configured as a Windows Service.
|
|
|
+ Defaults to `true`
|
|
|
+
|
|
|
+`STARTAFTERINSTALL`::
|
|
|
+
|
|
|
+ Whether the Windows Service is started after installation finishes.
|
|
|
+ Defaults to `true`
|
|
|
+
|
|
|
+`STARTWHENWINDOWSSTARTS`::
|
|
|
+
|
|
|
+ Whether the Windows Service is started when Windows is started.
|
|
|
+ Defaults to `true`
|
|
|
+
|
|
|
+`USELOCALSYSTEM`::
|
|
|
+
|
|
|
+ Whether the Windows service runs under the LocalSystem Account.
|
|
|
+ Defaults to `true`
|
|
|
+
|
|
|
+`USENETWORKSERVICE`::
|
|
|
+
|
|
|
+ Whether the Windows service runs under the NetworkService Account. Defaults
|
|
|
+ to `false`
|
|
|
+
|
|
|
+`USEEXISTINGUSER`::
|
|
|
+
|
|
|
+ Whether the Windows service runs under a specified existing account. Defaults
|
|
|
+ to `false`
|
|
|
+
|
|
|
+`USER`::
|
|
|
+
|
|
|
+ The username for the account under which the Windows service runs. Defaults to `""`
|
|
|
+
|
|
|
+`PASSWORD`::
|
|
|
+
|
|
|
+ The password for the account under which the Windows service runs. Defaults to `""`
|
|
|
+
|
|
|
+`CLUSTERNAME`::
|
|
|
+
|
|
|
+ The name of the cluster. Defaults to `elasticsearch`
|
|
|
+
|
|
|
+`NODENAME`::
|
|
|
+
|
|
|
+ The name of the node. Defaults to `%COMPUTERNAME%`
|
|
|
+
|
|
|
+`MASTERNODE`::
|
|
|
+
|
|
|
+ Whether Elasticsearch is configured as a master node. Defaults to `true`
|
|
|
+
|
|
|
+`DATANODE`::
|
|
|
+
|
|
|
+ Whether Elasticsearch is configured as a data node. Defaults to `true`
|
|
|
+
|
|
|
+`INGESTNODE`::
|
|
|
+
|
|
|
+ Whether Elasticsearch is configured as an ingest node. Defaults to `true`
|
|
|
|
|
|
- A unique identifier for the service. Useful if installing multiple instances on the same machine. Defaults to `elasticsearch-service-x86` (on 32-bit Windows) or `elasticsearch-service-x64` (on 64-bit Windows).
|
|
|
+`SELECTEDMEMORY`::
|
|
|
|
|
|
-`SERVICE_USERNAME`::
|
|
|
+ The amount of memory to allocate to the JVM heap for Elasticsearch.
|
|
|
+ Defaults to half of the available memory on the target machine, up to a maximum of 30.5GB
|
|
|
|
|
|
- The user to run as, defaults to the local system account.
|
|
|
+`LOCKMEMORY`::
|
|
|
|
|
|
-`SERVICE_PASSWORD`::
|
|
|
+ Whether `bootstrap.memory_lock` should be used to try to lock the process
|
|
|
+ address space into RAM. Defaults to `true`
|
|
|
|
|
|
- The password for the user specified in `%SERVICE_USERNAME%`.
|
|
|
+`UNICASTNODES`::
|
|
|
|
|
|
-`SERVICE_DISPLAY_NAME`::
|
|
|
+ A comma separated list of hosts in the form `host:port` or `host` to be used for
|
|
|
+ unicast discovery. Defaults to `""`
|
|
|
|
|
|
- The name of the service. Defaults to `Elasticsearch <version> %SERVICE_ID%`.
|
|
|
+`MINIMUMMASTERNODES`::
|
|
|
|
|
|
-`SERVICE_DESCRIPTION`::
|
|
|
+ The minimum number of master-eligible nodes that must be visible
|
|
|
+ in order to form a cluster. Defaults to `""`
|
|
|
|
|
|
- The description of the service. Defaults to `Elasticsearch <version> Windows Service - https://elastic.co`.
|
|
|
+`NETWORKHOST`::
|
|
|
|
|
|
-`JAVA_HOME`::
|
|
|
+ The hostname or IP address to bind the node to and _publish_ (advertise) this
|
|
|
+ host to other nodes in the cluster. Defaults to `""`
|
|
|
|
|
|
- The installation directory of the desired JVM to run the service under.
|
|
|
+`HTTPPORT`::
|
|
|
|
|
|
-`LOG_DIR`::
|
|
|
+ The port to use for exposing Elasticsearch APIs over HTTP. Defaults to `9200`
|
|
|
|
|
|
- Log directory, defaults to `%ES_HOME%\logs`.
|
|
|
+`TRANSPORTPORT`::
|
|
|
|
|
|
-`DATA_DIR`::
|
|
|
+ The port to use for internal communication between nodes within the cluster.
|
|
|
+ Defaults to `9300`
|
|
|
|
|
|
- Data directory, defaults to `%ES_HOME%\data`.
|
|
|
+`PLUGINS`::
|
|
|
|
|
|
-`CONF_DIR`::
|
|
|
+ A comma separated list of the plugins to download and install as part of the installation. Defaults to
|
|
|
+ `x-pack, ingest-attachment, ingest-geoip`
|
|
|
|
|
|
- Configuration file directory (which needs to include `elasticsearch.yml`
|
|
|
- and `log4j2.properties` files), defaults to `%ES_HOME%\conf`.
|
|
|
+To pass a value, simply append the property name and value using the format `<PROPERTYNAME>="<VALUE>"` to
|
|
|
+the installation command. For example, to use a different installation directory to the default one:
|
|
|
|
|
|
-`ES_JAVA_OPTS`::
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /i elasticsearch-{version}.msi /qn INSTALLDIR="C:\Custom Install Directory"
|
|
|
+--------------------------------------------
|
|
|
+
|
|
|
+Consult the https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988(v=vs.85).aspx[Windows Installer SDK Command-Line Options]
|
|
|
+for additional rules related to values containing quotation marks.
|
|
|
+
|
|
|
+[[msi-installer-command-line-running]]
|
|
|
+==== Running Elasticsearch from the command line
|
|
|
+
|
|
|
+Once installed, Elasticsearch can be started from the command line, if not installed as a service
|
|
|
+and configured to start when installation completes, as follows:
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+.\bin\elasticsearch.exe
|
|
|
+--------------------------------------------
|
|
|
+
|
|
|
+By default, Elasticsearch runs in the foreground, prints its logs to `STDOUT` in addition
|
|
|
+to the `<cluster name>.log` file within `LOGSDIRECTORY`, and can be stopped by pressing `Ctrl-C`.
|
|
|
|
|
|
- Any additional JVM system properties you may want to apply.
|
|
|
+[[msi-installer-command-line-configuration]]
|
|
|
+==== Configuring Elasticsearch on the command line
|
|
|
|
|
|
-`ES_START_TYPE`::
|
|
|
+Elasticsearch loads its configuration from the `%ES_HOME%\config\elasticsearch.yml`
|
|
|
+file by default. The format of this config file is explained in
|
|
|
+<<settings>>.
|
|
|
|
|
|
- Startup mode for the service. Can be either `auto` or `manual` (default).
|
|
|
+Any settings that can be specified in the config file can also be specified on
|
|
|
+the command line, using the `-E` syntax as follows:
|
|
|
|
|
|
-`ES_STOP_TIMEOUT` ::
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+.\bin\elasticsearch.exe -E cluster.name=my_cluster -E node.name=node_1
|
|
|
+--------------------------------------------
|
|
|
|
|
|
- The timeout in seconds that procrun waits for service to exit gracefully. Defaults to `0`.
|
|
|
+NOTE: Values that contain spaces must be surrounded with quotes. For instance `-E path.logs="C:\My Logs\logs"`.
|
|
|
|
|
|
-NOTE: At its core, `elasticsearch-service.bat` relies on http://commons.apache.org/proper/commons-daemon/[Apache Commons Daemon] project
|
|
|
-to install the service. Environment variables set prior to the service installation are copied and will be used during the service lifecycle. This means any changes made to them after the installation will not be picked up unless the service is reinstalled.
|
|
|
+TIP: Typically, any cluster-wide settings (like `cluster.name`) should be
|
|
|
+added to the `elasticsearch.yml` config file, while any node-specific settings
|
|
|
+such as `node.name` could be specified on the command line.
|
|
|
|
|
|
-NOTE: On Windows, the <<heap-size,heap size>> can be configured as for
|
|
|
-any other Elasticsearch installation when running Elasticsearch from the
|
|
|
-command line, or when installing Elasticsearch as a service for the
|
|
|
-first time. To adjust the heap size for an already installed service,
|
|
|
-use the service manager: `bin\elasticsearch-service.bat manager`.
|
|
|
+include::check-running.asciidoc[]
|
|
|
|
|
|
-Using the Manager GUI::
|
|
|
+[[msi-installer-windows-service]]
|
|
|
+==== Installing Elasticsearch as a Service on Windows
|
|
|
|
|
|
-It is also possible to configure the service after it's been installed using the manager GUI (`elasticsearch-service-mgr.exe`), which offers insight into the installed service, including its status, startup type, JVM, start and stop settings amongst other things. Simply invoking `elasticsearch-service.bat manager` from the command-line will open up the manager window:
|
|
|
+Elasticsearch can be installed as a service to run in the background or start
|
|
|
+automatically at boot time without any user interaction. This can be achieved upon installation
|
|
|
+using the following command line options
|
|
|
+
|
|
|
+* `INSTALLASSERVICE=true`
|
|
|
+* `STARTAFTERINSTALL=true`
|
|
|
+* `STARTWHENWINDOWSSTARTS=true`
|
|
|
|
|
|
-image::images/service-manager-win.png["Windows Service Manager GUI",align="center"]
|
|
|
+Once installed, Elasticsearch will appear within the Services control panel:
|
|
|
|
|
|
-Most changes (like JVM settings) made through the manager GUI will require a restart of the service in order to take affect.
|
|
|
+[[msi-installer-installed-service]]
|
|
|
+image::images/msi_installer/msi_installer_installed_service.png[]
|
|
|
|
|
|
-[[windows-layout]]
|
|
|
-==== Directory layout of `.zip` archive
|
|
|
+and can be stopped and restarted from within the control panel, or from the command line using:
|
|
|
|
|
|
-The `.zip` package is entirely self-contained. All files and directories are,
|
|
|
-by default, contained within `%ES_HOME%` -- the directory created when
|
|
|
-unpacking the archive.
|
|
|
+with Command Prompt:
|
|
|
|
|
|
-This is very convenient because you don't have to create any directories to
|
|
|
-start using Elasticsearch, and uninstalling Elasticsearch is as easy as
|
|
|
-removing the `%ES_HOME%` directory. However, it is advisable to change the
|
|
|
-default locations of the config directory, the data directory, and the logs
|
|
|
-directory so that you do not delete important data later on.
|
|
|
+[source,sh]
|
|
|
+--------------------------------------------
|
|
|
+sc.exe stop Elasticsearch
|
|
|
+sc.exe start Elasticsearch
|
|
|
+--------------------------------------------
|
|
|
|
|
|
+with PowerShell:
|
|
|
|
|
|
-[cols="<h,<,<m,<m",options="header",]
|
|
|
-|=======================================================================
|
|
|
-| Type | Description | Default Location | Setting
|
|
|
-| home
|
|
|
- | Elasticsearch home directory or `%ES_HOME%`
|
|
|
- d| Directory created by unpacking the archive
|
|
|
- |
|
|
|
+[source,powershell]
|
|
|
+--------------------------------------------
|
|
|
+Get-Service Elasticsearch | Stop-Service | Start-Service
|
|
|
+--------------------------------------------
|
|
|
|
|
|
-| bin
|
|
|
- | Binary scripts including `elasticsearch` to start a node
|
|
|
- and `elasticsearch-plugin` to install plugins
|
|
|
- | %ES_HOME%\bin
|
|
|
- d|
|
|
|
+Changes can be made to jvm.options and elasticsearch.yml configuration files to configure the
|
|
|
+service after installation. Most changes (like JVM settings) will require a restart of the
|
|
|
+service in order to take affect.
|
|
|
|
|
|
-| conf
|
|
|
- | Configuration files including `elasticsearch.yml`
|
|
|
- | %ES_HOME%\config
|
|
|
- | path.conf
|
|
|
+[[upgrade-msi-gui]]
|
|
|
+==== Upgrade using the graphical user interface (GUI)
|
|
|
|
|
|
-| data
|
|
|
- | The location of the data files of each index / shard allocated
|
|
|
- on the node. Can hold multiple locations.
|
|
|
- | %ES_HOME%\data
|
|
|
- | path.data
|
|
|
+The `.msi` package supports upgrading an installed version of Elasticsearch to a newer
|
|
|
+version of Elasticsearch. The upgrade process handles upgrading all installed plugins as
|
|
|
+well as retaining both your data and configuration.
|
|
|
|
|
|
-| logs
|
|
|
- | Log files location.
|
|
|
- | %ES_HOME%\logs
|
|
|
- | path.logs
|
|
|
+Downloading and clicking on a newer version of the `.msi` package will launch the GUI wizard.
|
|
|
+The first step will list the read only properties from the previous installation:
|
|
|
|
|
|
-| plugins
|
|
|
- | Plugin files location. Each plugin will be contained in a subdirectory.
|
|
|
- | %ES_HOME%\plugins
|
|
|
- |
|
|
|
+[[msi-installer-upgrade-notice]]
|
|
|
+image::images/msi_installer/msi_installer_upgrade_notice.png[]
|
|
|
|
|
|
-| 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
|
|
|
+The following configuration step allows certain configuration options to be changed:
|
|
|
|
|
|
-|=======================================================================
|
|
|
+[[msi-installer-upgrade-configuration]]
|
|
|
+image::images/msi_installer/msi_installer_upgrade_configuration.png[]
|
|
|
+
|
|
|
+Finally, the plugins step allows currently installed plugins to be upgraded or removed, and
|
|
|
+for plugins not currently installed, to be downloaded and installed:
|
|
|
+
|
|
|
+[[msi-installer-upgrade-plugins]]
|
|
|
+image::images/msi_installer/msi_installer_upgrade_plugins.png[]
|
|
|
+
|
|
|
+[[upgrade-msi-command-line]]
|
|
|
+==== Upgrade using the command line
|
|
|
+
|
|
|
+The `.msi` can also upgrade Elasticsearch using the command line. The simplest upgrade
|
|
|
+using the same defaults as the currently installed version is achieved by first
|
|
|
+navigating to the download directory, then running:
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /i elasticsearch-{version}.msi /qn
|
|
|
+--------------------------------------------
|
|
|
+
|
|
|
+Similar to the install process, a path to a log file for the upgrade process can
|
|
|
+be passed using the `/l` command line argument
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /i elasticsearch-{version}.msi /qn /l upgrade.log
|
|
|
+--------------------------------------------
|
|
|
+
|
|
|
+[[uninstall-msi-gui]]
|
|
|
+==== Uninstall using Add/Remove Programs
|
|
|
+
|
|
|
+The `.msi` package handles uninstallation of all directories and files added as part of installation.
|
|
|
+
|
|
|
+WARNING: Uninstallation will remove all directories and their contents created as part of
|
|
|
+installation, including data within the data directory. If you wish to retain your data upon
|
|
|
+uninstallation, it is recommended that you make a copy of the data directory before uninstallation.
|
|
|
+
|
|
|
+MSI installer packages do not provide a GUI for uninstallation. An installed program can be uninstalled
|
|
|
+by pressing the Windows key and typing `add or remove programs` to open the system settings.
|
|
|
+
|
|
|
+Once opened, find the Elasticsearch installation within the list of installed applications, click
|
|
|
+and choose `Uninstall`:
|
|
|
+
|
|
|
+[[msi-installer-uninstall]]
|
|
|
+image::images/msi_installer/msi_installer_uninstall.png[]
|
|
|
+
|
|
|
+This will launch the uninstallation process.
|
|
|
+
|
|
|
+[[uninstall-msi-command-line]]
|
|
|
+==== Uninstall using the command line
|
|
|
+
|
|
|
+Uninstallation can also be performed from the command line by navigating to the directory
|
|
|
+containing the `.msi` package and running:
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /x elasticsearch-{version}.msi /qn
|
|
|
+--------------------------------------------
|
|
|
+
|
|
|
+Similar to the install process, a path to a log file for the uninstallation process can
|
|
|
+be passed using the `/l` command line argument
|
|
|
+
|
|
|
+["source","sh",subs="attributes,callouts"]
|
|
|
+--------------------------------------------
|
|
|
+start /wait msiexec.exe /x elasticsearch-{version}.msi /qn /l uninstall.log
|
|
|
+--------------------------------------------
|
|
|
|
|
|
-include::next-steps.asciidoc[]
|
|
|
+include::next-steps.asciidoc[]
|
Russ Cam
