Add FAQ to readme file?

[Martin Koerner <martin.koerner@objectfab.de>]

Hello,

today we tried to update our application to
jruby 1.3.1
jruby-rack 0.9.5
warbler 0.9.14
rails 2.3.3

At localhost with Tomcat 6.0.16 and 6.0.20 (Windows Vista) everthing
works fine. At production server (Tomcat 6.0.16 under Gentoo Linux with
2.6.27 kernel), the app could not load rack:
SEVERE: Error: unable to initialize application
org.jruby.rack.RackInitializationException: no such file to load -- rack
        from
file:/tomcat_6.0.16/webapps/appname/WEB-INF/lib/jruby-rack-0.9.5.jar!/vendor/rack.rb:1
        from
file:/tomcat_6.0.16/webapps/appname/WEB-INF/lib/jruby-rack-0.9.5.jar!/vendor/rack.rb:22:in
`require'
        from
file:/tomcat_6.0.16/webapps/v/WEB-INF/lib/jruby-rack-0.9.5.jar!/jruby/rack/booter.rb:22:in
`boot!'
        from
file:/tomcat_6.0.16/webapps/appname/WEB-INF/lib/jruby-rack-0.9.5.jar!/jruby/rack/rails.rb:20:in
`boot!'
        from
file:/tomcat_6.0.16/webapps/appname/WEB-INF/lib/jruby-rack-0.9.5.jar!/jruby/rack/boot/rack.rb:9
        from
file:/tomcat_6.0.16/webapps/appname/WEB-INF/lib/jruby-rack-0.9.5.jar!/jruby/rack/boot/rack.rb:1:in
`load'

With a little experimenting we detected that a little earlier, in
jruby/rack/booter.rb, neither 'rubygems' nor 'rack' could be loaded.

We found the solution here:
http://archive.jruby.codehaus.org/lists/org.codehaus.jruby.user/msg/f8848eb80907091648k1422ce68v3c04e067593bc862@mail.gmail.com
(This mail archive seems to be removed)

Problem was, that the tomcat is started via a web-interface and so it's
working directory is not equal to $CATALINA_HOME.
So the solution was to add "cd $CATALINA_HOME" in catalina.sh, just
after $CATALINA_HOME is finally set.

I guess you have no influence on setting the path right, but is it
possible to add this to the readme file or create a faq? So other users
haven't to search as long as we do ;-)

Regards,

Martin





-- 
Martin Körner
ObjectFab GmbH
Loschwitzer Strasse 31
01309 Dresden

+49 351 3130420 (Telefon)
+49 351 3130424 (Fax)
Geschäftsführer: Steffen Gemkow
Amtsgericht Dresden, HRB 18176