Github user ygy commented on a diff in the pull request:
https://github.com/apache/incubator-brooklyn/pull/1015#discussion_r44409393
--- Diff: docs/website/documentation/faq.md ---
@@ -20,3 +20,29 @@ 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).
+
+Run `ulimit -a` to see the current limits.
+
+To increase the limits, 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
+
+Then apply these changes by running `sudo sysctl -p`.
--- End diff --
limits.conf is only read during login shells.
`sysctl -p` only enforces re-read of /etc/sysctl.conf
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
