anchor.diff:  [[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"]
   --------------------------------------------
  
positive.code:   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:
  
  ["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]
  
negative.code: ==== 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 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:
  