Github user ygy commented on a diff in the pull request:
https://github.com/apache/incubator-brooklyn/pull/1015#discussion_r44409172
--- 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.
+
--- End diff --
The correct setup for limits.conf is distribution specific. Maybe, it is
better to point out only the recommended values without suggesting changing OS
files and ask the user to consult distro's documentation.
---
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.
---
