Repository: incubator-brooklyn Updated Branches: refs/heads/master bc54d1d18 -> c48109a89
Add `Common problems' in the documentation Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/commit/2da9daea Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/tree/2da9daea Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/diff/2da9daea Branch: refs/heads/master Commit: 2da9daea976e8d1bcf84e6fefcb8f8aba251e146 Parents: cc30e6f Author: Valentin Aitken <[email protected]> Authored: Tue Nov 10 15:50:45 2015 +0200 Committer: Valentin Aitken <[email protected]> Committed: Tue Nov 17 12:02:24 2015 +0200 ---------------------------------------------------------------------- docs/website/documentation/faq.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-brooklyn/blob/2da9daea/docs/website/documentation/faq.md ---------------------------------------------------------------------- diff --git a/docs/website/documentation/faq.md b/docs/website/documentation/faq.md index 25d3864..7af5f80 100644 --- a/docs/website/documentation/faq.md +++ b/docs/website/documentation/faq.md @@ -20,3 +20,31 @@ Supplying the answers are a TODO. ## How do I supply answers? Click the "Edit this Page" link in the bottom right. + + +# Common Problems: + +## java.lang.OutOfMemoryError: unable to create new native thread + +You could encounter this error when running with many entities. + +Please **increase the ulimit** if you see such error: + +On the VM running Apache Brooklyn, we recommend ensuring nproc and nofile are reasonably high (e.g. higher than 1024, which is often the default). +We recommend setting it limits to a value above 16000. + +If you want to check the current limits run `ulimit -a`. + +Here are instructions for how to increase the limits for RHEL like distributions. +Run `sudo vi /etc/security/limits.conf` and add (if it is "brooklyn" user running Apache Brooklyn): + + brooklyn soft nproc 16384 + brooklyn hard nproc 16384 + brooklyn soft nofile 16384 + brooklyn hard nofile 16384 + + +Generally you do not have to reboot to apply ulimit values. They are set per session. +So after you have the correct values, quit the ssh session and log back in. + +For more details, see one of the many posts such as http://tuxgen.blogspot.co.uk/2014/01/centosrhel-ulimit-and-maximum-number-of.html
