Skip to content

Commit aa2dc7c

Browse files
committed
Add docs for error file configuration (#29032)
This commit adds docs for configuring the error file setting for where the JVM writes fatal error logs.
1 parent b221a5a commit aa2dc7c

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
[[error-file-path]]
2+
=== JVM fatal error logs
3+
4+
The <<rpm,RPM>> and <<deb,Debian>> package distributions default to configuring
5+
the JVM to write fatal error logs to `/var/lib/elasticsearch`; these are logs
6+
produced by the JVM when it encounters a fatal error (e.g., a segmentation
7+
fault). If this path is not suitable for receiving logs, you should modify the
8+
entry `-XX:ErrorFile=/var/lib/elasticsearch/hs_err_pid%p.log` in
9+
<<jvm-options,`jvm.options`>> to an alternate path.
10+
11+
Note that the archive distributions do not configure the error file path by
12+
default. Instead, the JVM will default to writing to the working directory for
13+
the Elasticsearch process. If you wish to configure an error file path, you
14+
should modify the entry `#-XX:ErrorFile=/error/file/path` in
15+
<<jvm-options,`jvm.options`>> to remove the comment marker `#` and to specify an
16+
actual path.

0 commit comments

Comments
 (0)