From dd95849b620194f9d2dbb0a1157c4a59553e7e25 Mon Sep 17 00:00:00 2001
From: Steve Kotsopoulos <sk@fywss.com>
Date: Thu, 5 Oct 2017 14:56:15 -0400
Subject: [PATCH] Document JVM option MaxFDLimit for macOS ()

This commit documents a JVM option that is needed on macOS when raising
file descriptor limits there.

Relates #26900
---
 docs/reference/setup/sysconfig/file-descriptors.asciidoc | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/reference/setup/sysconfig/file-descriptors.asciidoc b/docs/reference/setup/sysconfig/file-descriptors.asciidoc
index f4bc95749ae..17e7884be0d 100644
--- a/docs/reference/setup/sysconfig/file-descriptors.asciidoc
+++ b/docs/reference/setup/sysconfig/file-descriptors.asciidoc
@@ -16,6 +16,9 @@ For the `.zip` and `.tar.gz` packages, set <<ulimit,`ulimit -n 65536`>> as
 root before starting Elasticsearch,   or set `nofile` to `65536` in
 <<limits.conf,`/etc/security/limits.conf`>>.
 
+On macOS, you must also pass the JVM option `-XX:-MaxFDLimit`
+to Elasticsearch in order for it to make use of the higher file descriptor limit.
+
 RPM and Debian packages already default the maximum number of file
 descriptors to 65536 and do not require further configuration.