Installation and Configuration of JRuby

To develop and deploy Rails applications on the Enterprise Server, do the following:

1. Download and install JRuby.

2. Install Rails on top of your JRuby installation.

You can perform the above tasks by installing JRuby on your Enterprise Server instance in one of the following ways:

• Installing JRuby and the associated Gems on your Enterprise Server from Update Tool.

• Installing JRuby and Rails Gem directly

To Install JRuby and Rails from Update Center

JRuby and other associated Gems are now available as IPS packages from Update Center. By downloading them using the Update Tool, you can install them directly on your Enterprise Server.

For information about the Update Tool, see Sun GlassFish Enterprise Server v3 Installation Guide.

1. Start the update tool:

   as-install/bin/updatetool

2. From the Update Tool, choose the following packages from Available Add-Ons:

   • JRuby on GlassFish which contains JRuby 1.3.1

   • JRuby Gems which contains Rails 2.3.2, Warbler, jdbc-mysql, and activerecord-jdbcmysql-adapter packages.

3. Click Install, which will install the packages on your Enterprise Server instance.

4. Set your JRUBY_HOME environment variable to the location of your JRuby installation.

   export JRUBY_HOME=/jruby-install-location

5. Add JRUBY_HOME/bin directory to your system path so that you can invoke JRuby from anywhere in your directory tree.

   export PATH=$PATH:$JRUBY_HOME/bin

6. On the Windows operating system, use the following commands for Steps 4 and 5:

   set JRUBY_HOME=C:\jruby-install-location

   set PATH=%JRUBY_HOME%\bin;%PATH%

   ---

   Note - If GlassFish v3 JRuby IPS package was installed using update tool, then there is no need to set the jruby.home system property

   ---

To Install JRuby as Standalone

To install your own JRuby instance as standalone, use the following procedure.

1. Go to JRuby download site JRuby Download Site.

2. Download jruby-bin-1.3.1.zip or the latest version.

3. Unpack the zip file:

   unzip jruby-bin-1.3.1.zip

4. Set your JRUBY_HOME environment variable to the location of your JRuby installation:

   export JRUBY_HOME=/jruby-install-location

5. Add JRUBY_HOME/bin directory to your system path so that you can invoke JRuby from anywhere in your directory tree:

   export PATH=$PATH:$JRUBY_HOME/bin

6. If you want to use this JRuby installation with your Enterprise Server, use the following steps to inform and configure Enterprise Server instance with the location of the JRuby installation:

   1. Start your GlassFish installation:

      asadmin start-domain

   2. Set JRuby home:

      asadmin configure-jruby-container --jruby.home=/jruby-install-location

To Install Rails Gem on JRuby

If you installed your JRuby as a standalone instance, you also need to install the required Rails and other Gems on it. To install Rails, use the following procedure.

• Install the Rails Gem:

  jruby —S gem install rails

  The -S parameter that you used to run the command to install Rails tells JRuby to look for the script anywhere in the JRUBY_HOME path. With this command, JRuby and required Gems are installed on JRuby.