KNOWN_ISSUES

   1 = Known Issues
   2
   3 * Installing "unicorn" as a system-wide Rubygem and using the
   4   {isolate}[http://github.com/jbarnette/isolate] gem may cause issues if
   5   you're using any of the bundled application-level libraries in
   6   unicorn/app/* (for compatibility with CGI-based applications, Rails <=
   7   2.2.2, or ExecCgi).  For now workarounds include:
   8
   9   * installing the same version of unicorn as a system-wide Rubygem
  10     _and_ isolating unicorn as well.
  11   * explicitly setting RUBYLIB or $LOAD_PATH to include any gem path
  12     where the unicorn gem is installed (e.g.
  13     /usr/lib/ruby/gems/1.8/gems/unicorn-VERSION/lib)
  14
  15 * WONTFIX: code reloading and restarts with Sinatra 0.3.x (and likely older
  16   versions) apps is broken.  The workaround is to force production
  17   mode to disable code reloading as well as disabling "run" in your
  18   Sinatra application:
  19     set :env, :production
  20     set :run, false
  21   Since this is no longer an issue with Sinatra 0.9.x apps, this will not be
  22   fixed on our end.  Since Unicorn is itself the application launcher, the
  23   at_exit handler used in old Sinatra always caused Mongrel to be launched
  24   whenever a Unicorn worker was about to exit.
  25
  26   Also remember we're capable of replacing the running binary without dropping
  27   any connections regardless of framework :)