KNOWN_ISSUES

   1 = Known Issues
   2
   3 * Rails 2.3.2 bundles its own version of Rack.  This may cause subtle
   4   bugs when simultaneously loaded with the system-wide Rack Rubygem
   5   which Unicorn depends on.  Upgrading to Rails 2.3.4 (or later) is
   6   strongly recommended for all Rails 2.3.x users for this (and security
   7   reasons).  Rails 2.2.x series (or before) did not bundle Rack and are
   8   should be unnaffected.  If there is any reason which forces your
   9   application to use Rails 2.3.2 and you have no other choice, then
  10   you may edit your Unicorn gemspec and remove the Rack dependency.
  11
  12   ref: http://mid.gmane.org/20091014221552.GA30624@dcvr.yhbt.net
  13   Note: the workaround described in the article above only made
  14   the issue more subtle and we didn't notice them immediately.
  15
  16 * Installing "unicorn" as a system-wide Rubygem and using the
  17   {isolate}[http://github.com/jbarnette/isolate] gem may cause issues if
  18   you're using any of the bundled application-level libraries in
  19   unicorn/app/* (for compatibility with CGI-based applications, Rails <=
  20   2.2.2, or ExecCgi).  For now workarounds include:
  21
  22   * installing the same version of unicorn as a system-wide Rubygem
  23     _and_ isolating unicorn as well.
  24   * explicitly setting RUBYLIB or $LOAD_PATH to include any gem path
  25     where the unicorn gem is installed (e.g.
  26     /usr/lib/ruby/gems/1.8/gems/unicorn-VERSION/lib)
  27
  28 * WONTFIX: code reloading and restarts with Sinatra 0.3.x (and likely older
  29   versions) apps is broken.  The workaround is to force production
  30   mode to disable code reloading as well as disabling "run" in your
  31   Sinatra application:
  32     set :env, :production
  33     set :run, false
  34   Since this is no longer an issue with Sinatra 0.9.x apps, this will not be
  35   fixed on our end.  Since Unicorn is itself the application launcher, the
  36   at_exit handler used in old Sinatra always caused Mongrel to be launched
  37   whenever a Unicorn worker was about to exit.
  38
  39   Also remember we're capable of replacing the running binary without dropping
  40   any connections regardless of framework :)