Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document how to handle xtdb/crux out-of-memory errors #703

Closed
praseodym opened this issue Apr 11, 2023 · 0 comments · Fixed by #768
Closed

Document how to handle xtdb/crux out-of-memory errors #703

praseodym opened this issue Apr 11, 2023 · 0 comments · Fixed by #768
Assignees
Labels
documentation Improvements or additions to documentation xtdb

Comments

@praseodym
Copy link
Contributor

In bigger installations, xtdb/crux might need more memory to function properly. This will show up as xtdb repeatedly crashing with Terminating due to java.lang.OutOfMemoryError: Java heap space in its log.

We should document that this should be handled by giving xtdb more memory. The xtdb-http-multinode README contains some short instructions for this, namely increasing the Xmx (max heap) and maybe also MaxDirectMemorySize in the JAVA_TOOL_OPTIONS environment variable for the crux Docker container. The default for this variable is -Xms128M -Xmx512M -XX:MaxDirectMemorySize=512M -XX:+ExitOnOutOfMemoryError.

In the Debian package there are two different variables, namely MAX_MEMORY and MAX_DIRECT_MEMORY (see xtdb-http-multinode.service). I think these should be set using a systemd unit file override (systemctl edit).

@praseodym praseodym added documentation Improvements or additions to documentation xtdb labels Apr 11, 2023
@ring-ring-ring ring-ring-ring self-assigned this Apr 17, 2023
ring-ring-ring added a commit that referenced this issue Apr 19, 2023
@dekkers dekkers linked a pull request Apr 19, 2023 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation xtdb
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants