about summary refs log tree commit homepage
path: root/KNOWN_ISSUES
diff options
context:
space:
mode:
Diffstat (limited to 'KNOWN_ISSUES')
-rw-r--r--KNOWN_ISSUES20
1 files changed, 20 insertions, 0 deletions
diff --git a/KNOWN_ISSUES b/KNOWN_ISSUES
index e83e34e..c32d751 100644
--- a/KNOWN_ISSUES
+++ b/KNOWN_ISSUES
@@ -3,6 +3,14 @@
 Occasionally odd {issues}[link:ISSUES.html] arise without a transparent or
 acceptable solution.  Those issues are documented here.
 
+* Under Ruby 1.9.1, methods like Array#shuffle and Array#sample will
+  segfault if called after forking.  This is fixed in trunk (r26936) and
+  should be backported to the next 1.9.1 stable release (after p378).
+  Until then, it is advisable to call "Kernel.rand" in your after_fork
+  hook to reinitialize the random number generator.
+
+  See http://redmine.ruby-lang.org/issues/show/2962 for more details
+
 * When using "preload_app true", with apps using background threads
   need to restart them in the after_fork hook because threads are never
   shared with child processes.  Additionally, any synchronization
@@ -36,6 +44,18 @@ acceptable solution.  Those issues are documented here.
     where the unicorn gem is installed (e.g.
     /usr/lib/ruby/gems/1.8/gems/unicorn-VERSION/lib)
 
+  With current versions of isolate, it is also recommended that you
+  disable it with the <tt>before_exec</tt> hook prevent the PATH and
+  RUBYOPT environment variable modifications from propagating between
+  upgrades in your Unicorn config file:
+
+        before_exec do |server|
+          Isolate.disable
+        end
+
+  Future versions (unreleased as of 2010.04.20) of isolate will not
+  require this as environment variable modifications will be idempotent.
+
 * WONTFIX: code reloading and restarts with Sinatra 0.3.x (and likely older
   versions) apps is broken.  The workaround is to force production
   mode to disable code reloading as well as disabling "run" in your