diff options
-rw-r--r-- | docs/reference/setup/install/windows.asciidoc | 25 |
1 files changed, 18 insertions, 7 deletions
diff --git a/docs/reference/setup/install/windows.asciidoc b/docs/reference/setup/install/windows.asciidoc index b70ab34605..4abf087277 100644 --- a/docs/reference/setup/install/windows.asciidoc +++ b/docs/reference/setup/install/windows.asciidoc @@ -246,11 +246,11 @@ Defaults to `%ALLUSERSPROFILE%\Elastic\Elasticsearch\data` A comma separated list of the plugins to download and install as part of the installation. Defaults `""` 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: +the installation command. For example, to use a different installation directory to the default one and to install https://www.elastic.co/products/x-pack[X-Pack]: ["source","sh",subs="attributes,callouts"] -------------------------------------------- -start /wait msiexec.exe /i elasticsearch-{version}.msi /qn INSTALLDIR="C:\Custom Install Directory" +start /wait msiexec.exe /i elasticsearch-{version}.msi /qn INSTALLDIR="C:\Custom Install Directory" PLUGINS="x-pack" -------------------------------------------- Consult the https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988(v=vs.85).aspx[Windows Installer SDK Command-Line Options] @@ -339,8 +339,8 @@ service in order to take affect. ==== Upgrade using the graphical user interface (GUI) 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. +version of Elasticsearch. The upgrade process through the GUI handles upgrading all +installed plugins as well as retaining both your data and configuration. 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: @@ -362,9 +362,20 @@ 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: +The `.msi` can also upgrade Elasticsearch using the command line. + +[IMPORTANT] +=========================================== +A command line upgrade requires passing the **same** command line properties as +used at first install time; the Windows Installer does not remember these properties. + +For example, if you originally installed with the command line options `PLUGINS="x-pack"` and +`LOCKMEMORY="true"`, then you must pass these same values when performing an +upgrade from the command line. +=========================================== + +The simplest upgrade, assuming Elasticsearch was installed using all defaults, +is achieved by first navigating to the download directory, then running: ["source","sh",subs="attributes,callouts"] -------------------------------------------- |