From 80f16c45f9596a2763a0f34e581edaa13123ee0e Mon Sep 17 00:00:00 2001 From: Facundo Tuesca Date: Wed, 21 May 2025 14:32:49 -0400 Subject: [PATCH] chore: add workaround in dev docs for opensearch issue Signed-off-by: Facundo Tuesca --- docs/dev/development/getting-started.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/dev/development/getting-started.rst b/docs/dev/development/getting-started.rst index 3997600a013d..fd957ef86921 100644 --- a/docs/dev/development/getting-started.rst +++ b/docs/dev/development/getting-started.rst @@ -536,6 +536,21 @@ Errors when executing ``make initdb`` opensearch wants a lot of memory (Dustin gives warehouse ~4GB locally). Refer to the tip under :ref:`running-warehouse-containers` section for more details. +* If ``make initdb`` fails with an error like:: + + A fatal error has been detected by the Java Runtime Environment: + SIGILL (0x4) at pc=0x0000f819dfc67c5c, pid=25, tid=26 + + while building the ``warehouse-opensearch`` image, this is a known issue + with OpenSearch in Apple M4 processors. A workaround (described in + `this comment `_) + is to add the following line to ``dev/compose/opensearch/Dockerfile.yml`` (after + the FROM line): + + .. code-block:: docker + + ENV _JAVA_OPTIONS=-XX:UseSVE=0 + "no space left on device" when using ``docker compose`` ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^