Browse Source

Add note on temporary directory for Windows service

The Windows service will use a private temporary directory under the
user that is performing the installation. In cases when the service will
run as a different user, operators need a method to set this temporary
directory elsewhere. We have such a mechanism, so this commit merely
adds a note to the documentation on how to utilize it.

Relates #28712
Jason Tedor 7 years ago
parent
commit
4fe1c00a48
1 changed files with 8 additions and 0 deletions
  1. 8 0
      docs/reference/setup/install/zip-windows.asciidoc

+ 8 - 0
docs/reference/setup/install/zip-windows.asciidoc

@@ -196,6 +196,14 @@ 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`.
 
+NOTE: The service automatically configures a private temporary directory for use
+by Elasticsearch when it is running. This private temporary directory is
+configured as a sub-directory of the private temporary directory for the user
+running the installation. If the service will run under a different user, you
+can configure the location of the temporary directory that the service should
+use by setting the environment variable `ES_TMPDIR` to the preferred location
+before you execute the service installation.
+
 Using the Manager GUI::
 
 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: