» JRuby Project Wiki Home Page     » JRuby on Rails]

Goldspike

Java web applications are typically packaged as WAR files in preparation for distribution and deployment to Java EE servers. It is useful to be able to package Ruby on Rails applications in a similar form, to enable seamless deployment to Java servers. This is what Goldspike does.

Creating a WAR of a Rails application

Warbler

See Warbler for our currently recommended software to package your Rails applications as a .war file for deployment to a Java app server.

See also Jruby on Rails on Tomcat (Warbler related info).

Note this section will be expanded in the near future.

Goldspike Rake Plugin

First, install the plugin:

  script/plugin install http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins/goldspike

Note: The script above doesn't work on JRuby under Windows XP. You'll need to install the ActiveRecord-JDBC gem before you can use the rake-tasks below. You install it with the command:

 gem install activerecord-jdbc-adapter --no-rdoc --no-ri

Make sure that the plugin is installed, and run the following command:

 rake war:standalone:create

If you want to run a lot of JRuby web applications on an application server, it might be more efficient to install JRuby on your server's classpath and create a war containing just the application code:

 rake war:shared:create

Try out your application as a web archive using Jetty:

 rake war:standalone:run

Building Goldspike from source

Check out the source once:

• svn checkout svn://rubyforge.org/var/svn/jruby-extras/trunk/rails-integration
• cd rails-integration
• set GEM_HOME to point to your gem repository, so that the tests can be run (typically something like <jruby home>/lib/ruby/gems/1.8) (use "/" instead of "\" on Windows)
• mvn install

Development Environment

Eclipse

The following command will download all the required jar files and create the Eclipse project for you:

 mvn eclipse:eclipse

After this you need to set the M2_REPO variable within Eclipse to point to your local Maven repository. This is typically at ~/.m2/repository.

NetBeans

???

IntelliJ IDEA

The following command will download all the required jar files and create the project for you:

 mvn idea:idea 

Alternatively, you can open the pom directly on newer versions of IDEA, which will automatically convert it into a project.

How to Debug Problems

Frequently Asked Questions

Connecting to a database

To enable ActiveRecord you'll need to specify a database connection and package appropriate JDBC drivers.

Adding the JDBC driver is done by adding library dependencies into config/war.rb. Create it if it doesn't exist.

For example, the MySQL driver can be included in the WAR with the following line:

 maven_library 'mysql', 'mysql-connector-java', '5.0.4'

Next, configure database.yml to enable the use of ActiveRecord-JDBC as the ActiveRecord database driver.

Note: At present WAR files are set to production by default.

Using our MySQL example again, this becomes:

production:
  adapter: jdbc
  driver: com.mysql.jdbc.Driver
  url: jdbc:mysql://localhost/sample_production
  username: root
  password:
  host: localhost

Update config/environment.rb. See step '9' of Running Rails with ActiveRecord-JDBC.

Now when you use the web application, it should use JDBC drivers from Java to connect to the database.

Using a connection from a pool via JNDI

Rails-Integration comes with rake tasks to create a war file for the rails app and configure a jetty web server. To configure JNDI support, the following changes are required to be done...

1. Add the data source configuration to the jetty.xml file.

Note: Every time you run the rake task - war:standalone:run, the jetty.xml is recreated. Therefore, I suggest that you modify the rails-integration war plugin library, called run.rb and add the entries below in the appropriate place.

For instance, for Oracle data source:

    <new id="MyApp1" class="org.mortbay.jetty.plus.naming.Resource">
    <arg>jdbc/MyApp</arg>
    <arg>
    <new class="oracle.jdbc.pool.OracleConnectionPoolDataSource">
    <set name="URL">jdbc:oracle:thin:@192.168.2.23:1521:swami</set>
    <set name="User">myapp</set>
    <set name="Password">myapp</set>
    </new>
    </arg>
    </new>
 

For the full list of configuration details for various databases, see Jetty DataSource+Examples.

Note: As stated in the Jetty documentation, the above entries can be updated in jetty-env.xml or jetty-web.xml as well. The scope of this configuration depends on where you put this configuration information.

2. Now, search for the following section in your jetty.xml (or the run.rb file):

    <New class="org.mortbay.jetty.webapp.WebAppContext">

Add the following entries after the two <Arg> entries:

    <Set name="ConfigurationClasses">
    <Array id="plusConfig" type="java.lang.String">
    <Item>org.mortbay.jetty.webapp.WebInfConfiguration</Item>
    <Item>org.mortbay.jetty.plus.webapp.EnvConfiguration</Item>
    <Item>org.mortbay.jetty.plus.webapp.Configuration</Item>
    <Item>org.mortbay.jetty.webapp.JettyWebXmlConfiguration</Item>
    <Item>org.mortbay.jetty.webapp.TagLibConfiguration</Item>
    </Array>
    </Set>

3. Specify the JNDI Logical Name for the web application.

Add the following entries in your web.xml under WEB-INF folder of your war file.

Note: Every time you run the rake task - war:standalone:run, web.xml is recreated. Therefore, I suggest that you modify the rails-integration war plugin library create_war.rb and add the entries below in the appropriate place.

    <resource-ref>
    <description>My DataSource Reference</description>
    <res-ref-name>jdbc/MyApp</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
    </resource-ref>

Note: In the trunk version, the above entries are already added. All you have to do is setup the JNDI name in the property datasource_jndi_name inside war_config.rb.

4. To add JNDI support, Jetty requires two more libraries: Jetty-Naming and Jetty-Plus.

The best way to do this is to modify the rails-integration war plugin library war_config.rb. Search for add_jetty_library and append the following lines telling the war_config to download the two libraries as well:

    add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-plus', '6.1.1'))
    add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-naming', '6.1.1'))

5. Modify your database.yml to use JNDI.

    production:
      adapter: jdbc
      jndi: java:comp/env/jdbc/MyApp
      driver: oracle

Thats it! Your rails web application is ready to run with JNDI Data source.

How do I use a specific JRuby release?

Add the following line to config/war.rb

 maven_library 'org.jruby', 'jruby-complete', '0.9.9-SNAPSHOT'

Which version of Rails is used?

If RAILS_GEM_VERSION is set in environment.rb, this will be used. Otherwise, the latest installed release of Ruby on Rails is used.

However, you might want to manually specify a version of Rails to use. This can be done by adding a gem dependency to config/war.rb, such as:

 add_gem 'rails', '= 1.2.3'

Can I use servlet filters?

Yes you can. There is an example on how to do this on the CAS filter page.

How do you add JAR files to the resulting webapp?

Put them under lib/java (create that directory if needed), and they'll propagate to the resulting web application.

Note: I had to add a maven_library directive to my config/war.rb to make this work. In Goldspike 1.3, include_library(name,version) in config/war.rb is supposed to provide the ability to add Java libraries from either lib/java or JRUBY_HOME/lib, but the functionality has been broken for a while. A patch is available here:
http://rubyforge.org/tracker/index.php?func=detail&aid=13963&group_id=2014&atid=7859

Which Java EE servers can I use ?

GoldSpike has been tested on:

• GlassFish
• Jetty
• Tomcat
• WebLogic
• WebSphere

How do I add dependent gems to the war?

Use 'add_gem' in war.rb. For example:

 add_gem 'rmagick4j', '= 0.3.3'

How do I configure the number of requests GoldSpike can handle?

The number of simultaneous requests GoldSpike can process is based on the number of JRuby runtimes it creates.

Once GoldSpike has been run, it will create WEB-INF/web.xml under your Rails application. The following context-params in web.xml can be used to configure GoldSpike:

Maximum number of runtimes:

 jruby.pool.maxActive (defaults to 4)

Minimum number of runtimes:

 jruby.pool.minIdle (defaults to 2)

Initial number of runtimes:

 jruby.pool.initialSize (defaults to jruby.pool.minIdle)

How often in milliseconds to check if more runtimes are needed:

 jruby.pool.checkInterval (defaults to 1000)

What should I do? I get "Could not load Rails. See the logs for more details." error message.

This means that an exception was thrown while Goldspike attempted to initialize the Rails application. This can be caused by a number of problems, for example:

• Failure to connect to the database
• Missing gems from the war
• Missing required jars which are loaded from environment.rb

The best way to go about debugging this is to check the container log file. It should show the message and trace for the exception that was encountered.

How do I avoid bundling files such as .svn, .DS_Store, etc. into the WAR file?

I would LOVE to find the "proper" answer to this. I tried adding the following to war.rb, but it only caused an exclusion at the top level, possibly because the file list that finally gets passed to the jar command is only a list of the top-level files and directories:

 exclude_files File.join(".","**",".svn")

I ended up having to hack the Goldspike code to run the following zip command immediately after the WAR file was built (in packer.rb), which removes the designated files from the jar manually, throughout the ENTIRE jar file:

 zip -q -d #{os_target_file} \*.svn/\* \*.DS_Store

• os_target_file is the .jar filename
• .DS_Store is the OS X directory metadata file.
• Backslashes are significant and necessary: See the zip man page!

I can't think of a circumstance when you wouldn't want to exclude these files from a WAR, so I didn't make it an option. Works great.

web.xml Notes

After running warbler and looking at the resulting web.xml I was able to infer the following - please add or correct. Thx

Within your web.xml you can set the following to tailor the WAR structure to your liking. Set inside <web-app> like:

 <context-param>
 	<param-name>jruby.standalone</param-name>
 	<param-value>true</param-value>
 </context-param>

 jruby.standalone - true/false (what does this do?)
 jruby.session_store - "db"
 jruby.home
 jruby.pool.maxActive - 4
 jruby.pool.minIdle - 2
 jruby.pool.checkInterval - 1000 (ms)
 jruby.pool.maxWait - 30000 (ms)
 
 rails.root - path to rails app within the war file / webapp dir
 rails.env  - development|test|production
 
 files.root - absolute path to public files within the war file / webapp dir
 files.default - servlet id to use if a file cannot be found
 files.prefix - prefix added to static files
 files.welcome -

As with Rails, if a static file exists it will be served, otherwise it will try to dispatch via Rails.

Static file requests are (can be) serviced via org.jruby.webapp.FileServlet.

Rails requests are serviced via org.jruby.webapp.RailsServlet.

You should map / through the FileServlet

 <servlet-mapping>
 	<servlet-name>files</servlet-name>
 	<url-pattern>/</url-pattern>
 </servlet-mapping>

Additionally, System Properties you can set:

 jruby.objectspace.enabled
 gem.path
 gem.home

More Information

• Rails and Java EE integration - Servlet co-bundled and invoked from Rails app (Arun Gupta)
• RubyForge jruby-extras-devel Archives

Release roadmap

1.5 - January 08

• JRuby 1.1 support
• Rails 2.0 support
• Deprecate plugin, recommend the use of Warbler
• Bug 16108 - HttpOutput flush doesn't send headers - Patch by Matt Burke

1.4 - December 07

• Allow FileServlet to work even if activation.jar is not present at runtime
• Make rails.root param assume it's relative to the webapp
• Make pom download and install rails if necessary
• Added periodical task scheduler

1.3 - August 07

• Update to JRuby 1.0.1
• Support for WebLogic (tested with 9.2)
• Fix PUT, DELETE, etc requests not being passed on to RailsServlet.
• Add support for HEAD requests to FileServlet.
• Fix for a deadlock situation
• Add support for adding arbitrary files to WEB-INF, also looking at timestamps and so on to not add unnecessarily.
• Spring plugin
• Support for caching, by Li Xiao.
• Drop support for preparsing the syntax tree
• Don't add AR-JDBC or Rails gems if they're already added to vendor. By Michael Schubert.
• Servlet configuration templates are now created by a generator. By Bryan Liles.
• Support staggered start up of background tasks
• Make the servlet context directly available to Rails applications as $servlet_context
• Added RailsTaskServlet that makes it possible to run other Rails tasks such as for example ActiveMessaging
• Moved all runtime pool management out into a listener, for proper lifecycle management
• Added support for rails page caching
• Make system environment variables available at request time
• Running an embedded Jetty will now use RAILS_ENV (with a default of 'development') as the rails environment
• Assemble web application in place rather than using tmp/war
• MIT license
• Changed File.install to File.copy to improve performance
• Fix gem install courtesy Jeffrey Damick
• FileServlet can serve directly from an absolute paths

1.2 - May 07

• Bug 9711 - Tomcat 4 support
• Bug 10265 - Http session store
• Tests work with JDK 1.4

1.1.1 - April 23, 2007

• Bug 9321 - Better performance / Glassfish support (no runtime installation)
• Bug 9654 - JDK 1.4 support
• Enhancement 9999 - Support JNDI datasources
• Enhancement 10068 - Edge rails support

• Bug 9320 - NullpointerException in AbstractRailsServlet
• Bug 9394 - Allow deployment to root
• Bug 9419 - Ensure that ARGV is always available
• Enhancement 9710 - add_gem for config file
• Bug 9722 - Allow both symbols and strings for session keys
• Enhancement 10069 - Extra excludes paths
• Bug 10190 - java_library creates corrupt jar-files on windows
• Bug 10265 - fix marshalling issue with http servlet session store

''Note this section will be expanded in the near future.'' === Goldspike Rake Plugin === First, install the plugin: [[Home|» JRuby Project Wiki Home Page]]     [[JRubyOnRails|» JRuby on Rails]

Goldspike

Java web applications are typically packaged as WAR files in preparation for distribution and deployment to Java EE servers. It is useful to be able to package Ruby on Rails applications in a similar form, to enable seamless deployment to Java servers. This is what Goldspike does. ... === Goldspike Rake Plugin === First, install the plugin: script/plugin install http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins/goldspike'''Note:''' The script script/plugin install http://jruby-extras.rubyforge.org/svn/trunk/rails-integration/plugins/goldspike The above doesn't work on JRuby under Windows XP. above doesn't work on JRuby under Windows XP. You'll need to install the [[Running Rails with ActiveRecord-JDBC|ActiveRecord-JDBC]] gem before you can use the rake-tasks below. You install it with the command: gem install activerecord-jdbc-adapter --no-rdoc --no-ri Make sure that the plugin is installed, and run the following command: *You'll need to install the [[Running Rails with ActiveRecord-JDBC|ActiveRecord-JDBC]] gem before you can use the rake-tasks below. You install it with the command: gem install activerecord-jdbc-adapter --no-rdoc --no-ri Make sure that the plugin is installed, and run the following command: ... Make sure that the plugin is installed, and run the following command: rake war:standalone:create If you want to run a lot of JRuby web application rake war:standalone:create If you want to run a lot of JRuby webapps on an application server, it mays on an application server, it might be more efficient to install JRuby on your server' be more efficient to install JRuby on your servers classpath, and create a war containing just the application code: * rake war:shared:create Try out your application as a web archive using Jetty: * rake war:standalone:run == Building Goldspike from source == ... === Development Environment === ==== Eclipse ==== The following command will download all the required jar files and create the Eclipse project for you:

s classpath and create a war containing just the application code:
 rake war:shared:create

Try out your application as a web archive using Jetty:
...
=== Development Environment ===

==== Eclipse ====
The following command will download all the required jar files and create the Eclipse project for you: mvn eclipse:eclipse

mvn eclipse:eclipse After this you need to set the M2_REPO variable within Eclipse to point to your local Maven repository. This is typically at ~/.m2/repository. After this you need to set the M2_REPO variable within Eclipse to point to your local Maven repository. This is typically at ~/.m2/repository ... ==== IntelliJ IDEA ==== The following command will download all the required jar files and create the project for you:

==== NetBeans ====
??? 
...


==== IntelliJ IDEA ====
The following command will download all the required jar files and create the project for you: mvn idea:idea

Alternatively, you can open the pom directly on newer versions of IDEA, which will automatically convert it into a project. ... == Frequently Asked Questions == === Connecting to a database === To enable ActiveRecord you'll need to specify a database connection, and package appropriate JDBC drivers. Adding the JDBC driver is done by adding library dependencies into <i Alternatively, you can open the pom directly on newer versions of IDEA, which will automatically convert it into a project. ... === Connecting to a database === To enable ActiveRecord you'll need to specify a database connection and package appropriate JDBC drivers. Adding the JDBC driver is done by adding library dependencies into <tt>config/war.rbitt>.> (c Create it if it doesn't exist). For example, the MySQL driver can be included in the WAR with the following line:

reate it if it doesn't exist.

For example, the MySQL driver can be included in the WAR with the following line:
 maven_library 'mysql', 'mysql-connector-java', '5.0.4'

maven_library 'mysql', 'mysql-connector-java', '5.0.4' Next, configure database.yml to enable the use of ActiveRecord-JDBC Next, configure database.yml to enable the use of ActiveRecord-JDBC as the ActiveRecord database driver. Please n as the ActiveRecord database driver. '''Note:''' Aote that at t present WAR files are set to production by default. Using our MySQL example again, this becomes:

...
  host: localhost

Update config/environment.rb.present WAR files are set to production by default. Using our MySQL example again, this becomes:

...
  host: localhost

Update config/environment.rb s See step '9' of [[Running Rails with ActiveRecord-JDBC]]. Now when you use the web application, it should use JDBC drivers from Java to connect to the database. ... === Using a connection from a pool via JNDI === Rails-Integration comes with rake tasks to create a war file for the rails app and configure a [http://jetty.mortbay.org jetty] web server. To configure JNDI support, the following changes are required to be done... '''1. Add the data source configuration to the jetty.xmlee step '9' of [[Running Rails with ActiveRecord-JDBC]] Now when you use the web application, it should use JDBC drivers from Java to connect to the database. ... Rails-Integration comes with rake tasks to create a war file for the rails app and configure [http://jetty.mortbay.org jetty] web server. To configure JNDI support, the following changes are required to be done... 1. Add the data source configuration to the jetty.xml file. H file.''' '''Nowever, Please noote:'''te that e Every time you run the rake task - war:standalone:run, the jetty.xmlverytime you run the rake task - war:standalone:run, the jetty.xml is recreated. is recreated. Therefore, I suggest that you modify the rails-integration war plugin library, called run.rbTherefore, I suggest that you modify the rails-integration war plugin library, called run.rb and add the below e and add the entries below ntries in the appropriate place. For instance, for oin the appropriate place. For instance, for Oracle data source,: <new id="MyApp1" class="org.mortbay.jetty.plus.naming.Resource"> <arg>jdbc/MyApp</arg> ... <set name="Password">myapp</set> </new> </arg> </new> For the full list of configuration details for various databases, plea <new id="MyApp1" class="org.mortbay.jetty.plus.naming.Resource"> <arg>jdbc/MyApp</arg> ... </arg> </new> For the full list of configuration details for various databases, seese go [http://docs.codehaus.org/display/JETTY/DataSource+Examples h [http://docs.codehaus.org/display/JETTY/DataSource+Examples Jetty DataSourcere] Pe+Examplease nles]. '''Note:''' As sote that,tated asinpther je Jetty documentation, the above entries can be updated in jetty-env.xml or jetty-web.xml as well. The scope of this configuration depends on where you put this configuration information. '''2. Now, search for the following section in your jetty.xml (or the run.rb file):'''etty documentation, the above entries can be updated in jetty-env.xml or jetty-web.xml as well. The scope of this configuration depends on where you put this configuration information. 2. Now, search for the section <New class="org.mortbay.jetty.webapp.WebAppContext"> in your jetty.xml(or the run.rb file) an <New class="org.mortbay.jetty.webapp.WebAppContext"> Ad ad the following entries after the two <Arg> entries...dd the following entries after the two <Arg> entries: <Set name="ConfigurationClasses"> <Array id="plusConfig" type="java.lang.String"> <Item>org.mortbay.jetty.webapp.WebInfConfiguration</Item> <Item>org.mortbay.jetty.plus.webapp.EnvConfiguration</Item> ... <Item>org.mortbay.jetty.webapp.JettyWebXmlConfiguration</Item> <Item>org.mortbay.jetty.webapp.TagLibConfiguration</Item> </Array> </Set> <Set name="ConfigurationClasses"> <Array id="plusConfig" type="java.lang.String"> <Item>org.mortbay.jetty.webapp.WebInfConfiguration</Item> ... <Item>org.mortbay.jetty.webapp.JettyWebXmlConfiguration</Item> <Item>org.mortbay.jetty.webapp.TagLibConfiguration</Item> </Array> </Set>'''3. Now, we need to sSpecify the JNDI Logical Name for ourthe web application, a.''' Add the following entries in your web.xmldd the following entries in your web.xml under WEB-INF folder of your war file. H under WEB-INF folder of your war file. '''Nowever, Please noote:'''te that e Every time you run the rake task - war:standalone:run, web.xml is recreated. Therefore, I suggest that you modify the rails-integration war plugin library,very time you run the rake task - war:standalone:run, web.xml is recreated. Therefore, I suggest that you modify the rails-integration war plugin library called ccreate_war.rbreate_war.rb and add the below e and add the entries below ntries in the appropriate place. in the appropriate place. <resource-ref> <description>My DataSource Reference</description> <res-ref-name>jdbc/MyApp</res-ref-name> ... <res-auth>Container</res-auth> </resource-ref> '''Note:''' <resource-ref> <description>My DataSource Reference</description> <res-ref-name>jdbc/MyApp</res-ref-name> <res-type>javax.sql.DataSource</res-type> ... <res-auth>Container</res-auth> </resource-ref> '''In the trunk version, the above entries are already added. All you have to do is setup the jndiIn the trunk version, the above entries are already added. All you have to do is setup the JNDI name in the property "datasource_jndi_name" inside war_config.rb. inside war_config.rb.''' 4. Lastly, t'''4. To add JNDI support, jJetty requires two more libraries: Jetty-Naming and Jetty-Plus.''' etty requires two more libraries Jetty-Naming and Jetty-Plus. The best way to do this is to modify the rails-integration war plugin library, called The best way to do this is to modify the rails-integration war plugin library war_config.rb. Search for <war_config.rb. Search for the word tt>add_jetty_libraryadd_jetty_library and append the following lines telling the war_config to download the two libraries as well. and append the following lines telling the war_config to download the two libraries as well: add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-plus', '6.1.1')) add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-naming', '6.1.1')) ''' add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-plus', '6.1.1')) add_jetty_library(maven_library('org.mortbay.jetty', 'jetty-naming', '6.1.1')) 5. N5. Mow for the final step, moodify your database.ymldify your database.yml to use jndi to use JNDI...''' production: adapter: jdbc jndi: java:comp/env/jdbc/MyApp driver: oracle ... Thats it! Your rails web application is ready to run with JNDI Data source. === How do I use a specific JRuby release? === Add the following line to <i production: adapter: jdbc jndi: java:comp/env/jdbc/MyApp ... Thats it! Your rails web application is ready to run with JNDI Data source. === How do I use a specific JRuby release? === Add the following line to <tt>config/war.rbitt>

 maven_library 'org.jruby', 'jruby-complete', '0.9.9-SNAPSHOT'

maven_library 'org.jruby', 'jruby-complete', '0.9.9-SNAPSHOT' === Which version of Rails is used? === If RAILS_GEM_VERSION is set in environment.rb === Which version of Rails is used? === If RAILS_GEM_VERSION is set in environment.rb, then this will be used,, this will be used. oOtherwise,therwise the latest installed release of Ruby on Rails is used. However, you may the latest installed release of Ruby on Rails is used. However, you might want to manually specify a version of Rails to use. This can be done by adding a gem dependency to <itt>config/war.rbitt>, such as:

 add_gem 'rails', '= 1.2.3'

=== Can I use servlet filters? === Yes you can. There is an example on how to do this on the [[CAS filter]] page. === How do you add JAR files to the resulting webapp? === add_gem 'rails', '= 1.2.3' === Can I use servlet filters? === Yes you can. There is an example on how to do this on the [[CAS filter]] page. ... Yes you can. There is an example on how to do this on the [[CAS filter]] page. === How do you add JAR files to the resulting webapp? === Put them under lib/java (create that directory if needed), and they'll propagate to the resulting web application. '''Note:''' I had to add a maven_library directive to my config/war.rbPut them under lib/java (create that dir if needed) and they'll propagate to the resulting webapp. ''I had to add a maven_library directive to my config/war.rb as well in order to make this work.'' '' to make this work. In gGoldspike 1.3, include_library(name,version) in config/war.rboldspike 1.3, include_library(name,version) in config/war.rb is supposed to provide the ability to add j is supposed to provide the ability to add Java libraries from either lib/javaava libraries from either lib/java or jruby or JRUBY_homeHOME/lib/lib, but the functionality has been broken for a while. A patch is available here: , but the functionality has been broken for a while. A patch is available here:
http://rubyforge.org/tracker/index.php?func=detail&aid=13963&group_id=2014&atid=7859'' === Which Java EE servers can I use ? === GoldSpike has been tested on: ... * [http://www.ibm.com/developerworks/websphere/techjournal/0801_shillington/0801_shillington.html WebSphere] === How do I add dependent gems to the war? === Use 'add_gem' in war.rb. Ehttp://rubyforge.org/tracker/index.php?func=detail&aid=13963&group_id=2014&atid=7859 === Which Java EE servers can I use ? === GoldSpike has been tested on: ... * [http://www.ibm.com/developerworks/websphere/techjournal/0801_shillington/0801_shillington.html WebSphere] === How do I add dependent gems to the war? === Use 'add_gem' in war.rb. For example: add_gem 'rmagick4j', '= 0.3.3' === How do I configure the number of requests GoldSpike can handle? === ... === How do I configure the number of requests GoldSpike can handle? === The number of simultaneous requests GoldSpike can process is based on the number of JRuby runtimes it creates. Once GoldSpike has been run, it will create WEB-INF/web.xml under your Rails application. The following context-params in web.xmlxample: add_gem 'rmagick4j', '= 0.3.3' === How do I configure the number of requests GoldSpike can handle? === ... The number of simultaneous requests GoldSpike can process is based on the number of JRuby runtimes it creates. Once GoldSpike has been run, it will create WEB-INF/web.xml under your Rails application. The following context-params in web.xml can be used to configure GoldSpike:* can be used to configure GoldSpike: Maximum number of runtimes: jruby.pool.maxActive (defaults to 4) ** maxjruby.pool.maxActive (defaults to 4) Minimum number of runtimes: imum number of runtimes * jruby.pool.minIdle (defaults to 2) ** mi jruby.pool.minIdle (defaults to 2) Inimumtial number of runtimes: number of runtimes * jruby.pool.initialSize (defaults to jruby.pool.minIdle) ** jruby.pool.initialSize (defaults to jruby.pool.minIdle) How inioftialen i nun mbilliserconds to check if more runtimes are needed: of runtimes * jruby.pool.checkInterval (defaults to 1000) ** How often in milliseconds should we check whether more runtimes are needed? === What should I do? I get "Could not load Rails. See the logs for more details." error message. === jruby.pool.checkInterval (defaults to 1000) === What should I do? I get "Could not load Rails. See the logs for more details." error message. === ... This means that an exception was thrown while Goldspike attempted to initialize the Rails application. This can be caused by a number of problems, for example: * Failure to connect to the database * Missing gems from the war * Missing required jars which are loaded from environment.rb The best way to go about debugging this is to check the container log file. It should show the message and trace for the exception that was encountered. === How do I avoid bundling files such as .svn, .DS_Store, etc. into the WAR file? === I would LOVE to find the "proper" answer to this. I tried adding the followThis means that an exception was thrown while Goldspike attempted to initialize the Rails application. This can be caused by a number of problems, for example: * Failure to connect to the database * Missing gems from the war * Missing required jars which are loaded from environment.rb ... The best way to go about debugging this is to check the container log file. It should show the message and trace for the exception that was encountered. === How do I avoid bundling files such as .svn, .DS_Store, etc. into the WAR file? === I would LOVE to find the "proper" answer to this. I tried adding thising to war.rb to war.rb, but it only caused an exclusion at the top level, possibly because the file list that finally gets passed to the ", but it only caused an exclusion at the top level, possibly because the file list that finally gets passed to the jar" command is only a list of the top-level files/ and directories: exclude_files File.join(".","**",".svn") I ended up having to hack the Goldspike code to run the followdirectories: exclude_files File.join(".","**",".svn") I ended up having to hack the Goldspike code to run thising zip command immediately after the WAR file was built (in packer.rb zip command immediately after the WAR file was built (in packer.rb), which removes the designated files from the jar manually, throughout the ENTIRE jar file: zip -q -d #{os_target_file} \*.svn/\* \*.DS_Store (), which removes the designated files from the jar manually, throughout the ENTIRE jar file: zip -q -d #{os_target_file} \*.svn/\* \*.DS_Store *os_target_file is the .jar filename, * .DS_Store is the OS X directory metadata file. * .DS_Store is the OS X directory metadata file. Backslashes are significant/Backslashes are significant and nnecessary,ecessary: sSee the zip man page!)ee the zip man page! I can't think of a circumstance when you wouldn't want to exclude these files from a WAR, so I didn't make it an option. Works great. ... ''After running warbler and looking at the resulting web.xml I was able to infer the following - please add or correct. Thx'' Within your web.xml you can set the following to tailor the WAR structure to your liking. Set inside <web-app> like:

 
 	jruby.standalone
 	true
 

I can't think of a circumstance when you wouldn't want to exclude these files from a WAR, so I didn't make it an option. Works great. ... jruby.standalone - true/false (what' jruby.standalone - true/false (what does this do?) jruby.session_store - "db" jruby.home jruby.pool.maxActive - 4 ... jruby.pool.maxActive - 4 jruby.pool.minIdle - 2 jruby.pool.checkInterval - 1000 (ms) jruby.pool.maxWait - 30000 (ms) rails.root - path to rails app within the war file / webapp dir rails.env - development|test|production files.root - absolute path to public files within the war file / webapp dir files.default - servlet id to use if a file cannot be found files.prefix - prefix added to static files ... As with Rails, if a static file exists it will be served, otherwise it will try to dispatch via Rails. Static file requests are (can be) serviced via org.jruby.webapp.FileServlet. Rails requests are serviced via org.jruby.webapp.RailsServlet. You should map / through the FileServlet

 
 	files
 	/
 

s this do?) jruby.session_store - "db" jruby.home jruby.pool.maxActive - 4 ... Additionally - Additionally, System Properties you can set: jruby.objectspace.enabled gem.path