Add note on LightGBM/OpenMP hanging on AWS Batch (#3553)

* Add note on LightGBM/OpenMP hanging on AWS Batch * Update docs/FAQ.rst Co-authored-by: James Lamb <jaylamb20@gmail.com> Co-authored-by: James Lamb <jaylamb20@gmail.com>
microsoft · Nov 11, 2020 · 2ad21ab · 2ad21ab
1 parent e9f5169
commit 2ad21ab
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/FAQ.rst b/docs/FAQ.rst
@@ -172,6 +172,10 @@ For C/C++ users, any OpenMP feature cannot be used before the fork happens. If a
 fork happens (example: using OpenMP for forking), OpenMP will hang inside the forked sessions. Use new processes instead
 and copy memory as required by creating new processes instead of forking (or, use Intel compilers).
 
+Cloud platform container services may cause LightGBM to hang, if they use Linux fork to run multiple containers on a 
+single instance. For example, LightGBM hangs in AWS Batch array jobs, which `use the ECS agent 
+<https://aws.amazon.com/batch/faqs/#Features>`__ to manage multiple running jobs. Setting ``nthreads=1`` mitigates the issue.
+
 12. Why is early stopping not enabled by default in LightGBM?
 -------------------------------------------------------------