Miles to go …

Substruct is an open-source E-Commerce project written using Ruby-on-Rails framework. It provides a simple e-commerce platform, content management system and customer response system – all in one.

I found out about this application from Sang “Passion” Shin‘s Lab 5542 (part of FREE 20-week course on Ruby-on-Rails starting on Jul 15, 2008). But instead of using standard WEBrick/Mongrel deployment, I describe the steps to deploy this application using GlassFish v3 Gem. The GlassFish Gem installation is described here.

1. Download and install Substruct

   ~/samples/jruby >gunzip -c substruct_rel_1-0-a3.tar.gz  | tar xvf - substruct_rel_1-0-a3/ substruct_rel_1-0-a3/app/ substruct_rel_1-0-a3/app/controllers/ substruct_rel_1-0-a3/app/controllers/application.rb . . . substruct_rel_1-0-a3/vendor/rails/railties/test/rails_info_test.rb substruct_rel_1-0-a3/vendor/rails/railties/test/secret_key_generation_test.rb substruct_rel_1-0-a3/vendor/rails/Rakefile substruct_rel_1-0-a3/vendor/rails/release.rb

2. Install the required gems for Substruct
   

   ~/samples/jruby >~/testbed/jruby-1.1.2/bin/jruby -S gem install RedCloth fastercsv mime-types mini_magick ezcrypto jruby-openssl –no-ri –no-rdoc JRuby limited openssl loaded. gem install jruby-openssl for full support. http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL Bulk updating Gem source index for: http://gems.rubyforge.org/ Successfully installed RedCloth-3.0.4 Successfully installed fastercsv-1.2.3 Successfully installed mime-types-1.15 Successfully installed rubyforge-1.0.0 Successfully installed hoe-1.5.3 Successfully installed mini_magick-1.2.3 Successfully installed ezcrypto-0.7 Successfully installed jruby-openssl-0.2.3 8 gems installed

3. Create the database
   

   ~/samples/jruby/substruct_rel_1-0-a3 >~/testbed/jruby-1.1.2/bin/jruby -S rake db:create (in /Users/arungupta/samples/jruby/substruct_rel_1-0-a3) [SUBSTRUCT WARNING] Mail server settings have not been initialized. Check to make sure they’ve been set in the admin panel.

4. And bootstrap it as
   

   ~/samples/jruby/substruct_rel_1-0-a3 >~/tesbted/jruby-1.1.2/bin/jruby -S rake substruct:db:bootstrap (in /Users/arungupta/samples/jruby/substruct_rel_1-0-a3) Checking requirements… Initializing database… [SUBSTRUCT WARNING] Mail server settings have not been initialized. Check to make sure they’ve been set in the admin panel. — create_table(“content_nodes”, {:force=>true})    -> 0.3020s — add_index(“content_nodes”, ["name"], {:name=>”name”})    -> 0.0140s — add_index(“content_nodes”, ["type", "id"], {:name=>”type”}) . . . — initialize_schema_information()    -> 0.0200s — columns(“schema_info”)    -> 0.0650s Clearing previous data… Removing all sessions… Loading default data… …done. ================================================================================ Thanks for trying Substruct 1.0.a3 Now you can start the application with ‘script/server’ visit: http://localhost:3000/admin, and log in with admin / admin. For help, visit the following:   Official Substruct Sites     – http://substruct.subimage.com     – http://code.google.com/p/substruct/   Substruct Google Group – http://groups.google.com/group/substruct – Subimage LLC – http://www.subimage.com

5. And finally run it on the GlassFish as:
   

   ~/samples/jruby >~/testbed/jruby-1.1.2/bin/jruby -S glassfish_rails substruct_rel_1-0-a3 May 28, 2008 1:47:46 PM com.sun.enterprise.glassfish.bootstrap.ASMain main INFO: Launching GlassFish on HK2 platform May 28, 2008 1:47:46 PM com.sun.enterprise.glassfish.bootstrap.ASMainHK2 findDerbyClient INFO: Cannot find javadb client jar file, jdbc driver not available May 28, 2008 1:47:47 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3000 May 28, 2008 1:47:47 PM com.sun.enterprise.v3.services.impl.GrizzlyEmbeddedHttpConfigurator configureSSL WARNING: pewebcontainer.all_ssl_protocols_disabled May 28, 2008 1:47:47 PM com.sun.enterprise.v3.services.impl.GrizzlyEmbeddedHttpConfigurator configureSSL WARNING: pewebcontainer.all_ssl_ciphers_disabled May 28, 2008 1:47:47 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3131 May 28, 2008 1:47:47 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3838 May 28, 2008 1:47:48 PM com.sun.enterprise.v3.admin.adapter.AdminConsoleAdapter setContextRoot INFO: Admin Console Adapter: context root: /admin May 28, 2008 1:47:48 PM com.sun.enterprise.rails.RailsDeployer registerAdapter INFO: Loading application substruct_rel_1-0-a3 at / May 28, 2008 1:47:48 PM  INFO: Starting Rails instances May 28, 2008 1:47:56 PM com.sun.grizzly.jruby.RubyObjectPool$1 run INFO: Rails instance instantiation took : 8800ms May 28, 2008 1:47:56 PM com.sun.enterprise.v3.server.AppServerStartup run INFO: Glassfish v3 started in 10403 ms

The welcome screenshot looks like

Now copy GlassFish logo image file to “public/images” directory of your application and add the following line to “app/views/layouts/main.rhtml” file (on line 36):

able style="text-align: left; width: 100%;" cellpadding="2" cellspacing="2">

The modified view looks like as shown below:

The updated output looks like:

I tried only the basic deployment and that seem to work. If you try slightly more advanced usecases then the functionality provided by RedCloth, fastercsv, mime-types, mini_magick and ezcrypto gems can be exercised as well. If you are running Substruct, try it and .

If your Rails application does not work on the gem, file bugs here with “jruby” as “subcomponent” (default version is “v3″).

Also check out Redmine on GlassFish v3.

Technorati: rubyonrails glassfish netbeans substruct webtier

Vivek released 0.3.0 version of GlassFish Gem for Rails (a total of 11 issues fixed and resolved – RubyForge & GlassFish Issue Tracker) earlier. But that caused a regression on #4228. And so matching the agility expected by Rails developers, he quickly released 0.3.1. And a wee bit smaller too – 2.68MB for 0.3.1 instead of 2.69MB for 0.3.0.

If you have an existing version of the gem, then you just need to update it:

If the gem has never been installed, then you install it as:

And make sure next time you have to update the gem instead of installing from scratch For that, just install the gem this time and let us know your feedback on GlassFish Webtier Forum or Webtier Alias. If any of your Rails application do not work then please file bugs at GlassFish Issue Tracker (“V3″ as “Found in Version:” and “jruby” as “Subcomponent:”).

The gem installation may require to set “JAVA_MEM=-Xmx800m” because of the growing memory requirements. Otherwise you may get “Exception in thread “main” java.lang.OutOfMemoryError: Java heap space“.

Try a simple scaffold application to see the output as shown below:

The startup output in the gem console (output from GlassFish) is:

and then the console is updated as more entries are added (output from Rails):

Redmine seems to have issues with Rails 2.1. I’ll play with some other applications later. But have you tried deploying your Rails application on GlassFish gem ? As mentioned above, let us know your feedback on GlassFish Webtier Forum or Webtier Alias and file bugs on GlassFish Issue Tracker.

Details about previous versions are available at 0.2.0, 0.1.2, 0.1.1, 0.1.0.

Technorati: glassfish v3 rubyonrails jruby ruby gem

My primary development machine is Mac OS Leopard on Intel Core 2 Duo (read osxtips). But the beauty of virtualization is that I can run multiple Operating Systems on a single powerful machine. And what better virtualization product than Virtual Box. And  Open Solaris has crossed leaps and boundaries making installation and getting started extremely simple

So here is an application stack that I tried:

Rails 2.1 + My SQL 5.0.51a JRuby 1.1.2 GlassFish v3 TP2 OpenSolaris 2008.05 Virtual Box 1.6.2 Mac OSX Leopard Intel 2.4 G Hz Core 2 Duo

You can easily deploy your Rails applications using MySQL database on GlassFish installed on OpenSolaris in a Virtual Box VM on Mac OS Leopard running on an Intel 2 Duo processor machine. Overall a happy experience

The complete instructions to install OpenSolaris using Virtual Box are very useful.

Here are basic steps …

Create a new VM (settings given in the instructions):

Once all the options are chosen, the generated VM settings are shown as below:

Booting the Virtual Machine from the Live CD shows the following GRUB:

Pick the default options (GRUB, Keyboard & Language) and then the following default screen is shown:

Read and Close the license screen. And then click on the “Install Open Solaris” icon to continue the installation process. This step is important otherwise you’ll keep booting from LiveCD every time (I messed up on this few times .

After choosing the Region, Location & Timezone and taking other defaults, the summarized installation options are shown:

And finally the installation is complete:

After the installation is complete, shutdown the VM by either selecting “System, Shut Down…” or click on the X on the VM window and selecting “Power off the machine”. Change the boot sequence order to bring “Hard Disk” at the top by clicking on “Settings”, “Advanced” tab and changing the order as shown below.

And finally, you can easily deploy a Rails 2.1 application on this newly configured machine as explained in Rails 2.1 on GlassFish.  TOTD #35 explains how Rails Database connection need to be configured on Solaris.
The final output of the application looks like:

Here are some pointers for you to get started:

• Virtual Box 1.6.2
• OpenSolaris 2008.05
• GlassFish v3 TP2
• JRuby 1.1.2
• Rails powered by the GlassFish Application Server

Did you know the 3 keywords for GlassFish v3 – Modularity (OSGi compliant), Extensiblity (non-Java apps) & Emebeddability (runs in-VM) ? Read more on GlassFish v3 main page.

Stay in touch with us by posting your questions/comments/concerns to GlassFish Web Tier Forum or .

Technorati: rubyonrails jruby ruby opensolaris virtualbox mac glassfish v3

Are you deploying your JRuby-on-Rails applications on Solaris (or any variety of Unix) and not able to connect to the database ?

I experienced it last week so thought of sharing the tip here. Luckily it’s really simple.

Here is the default generated “config/database.yml”

The only required change is to add “host: 127.0.01″ for the required database configuration. The updated fragment is shown below (with change highlighted):

Even though “host” is required for TCP connections but the database connection does not seem to work without this entry. The exact same application works without “host” entry on Windows and Mac OS.

Alternatively, you can always install the JDBC adapter as explained here.

Please leave suggestions on other TOTD (Tip Of The Day) that you’d like to see. A complete archive is available here.

Technorati: totd rubyonrails jruby ruby opensolaris mysql

Rails 2.1 was released earlier this month. GlassFish provides a complete development/deployment environment for Rails applications. Some of the main reasons for using GlassFish (instead of WEBrick or Mongrel) are:

• Identical Development and Deployment environment
• Multiple Applications can be deployed on one Container
• Multiple requests can be handled by a single application (with no extra configuration)
• Out-of-the-box Clustering, Load Balancing and High Availability
• Database connection pooling
• Co-hosting Rails and Java EE applications

More details are available in Rails powered by the GlassFish Application Server. This blog provides detailed instructions to get started with Rails 2.1 on GlassFish.

1. Install Rails 2.1 in a JRuby 1.1.2 installation:

   ~/testbed/rails21/jruby-1.1.2 >bin/jruby -S gem install rails –no-ri –no-rdoc JRuby limited openssl loaded. gem install jruby-openssl for full support. http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL Updating metadata for 253 gems from http://gems.rubyforge.org/ ……………………………………………………………………. ……………………………………………………………………. ……………………………………………………………………. ……………. complete Bulk updating Gem source index for: http://gems.rubyforge.org/ Successfully installed activesupport-2.1.0 Successfully installed activerecord-2.1.0 Successfully installed actionpack-2.1.0 Successfully installed actionmailer-2.1.0 Successfully installed activeresource-2.1.0 Successfully installed rails-2.1.0 6 gems installed

2. Create a new Rails app as:
   

   ~/testbed/rails21/jruby-1.1.2/samples/rails >../../bin/jruby -S rails -d mysql runner       create         create  app/controllers       create  app/helpers       create  app/models       create  app/views/layouts       create  config/environments       create  config/initializers       create  db       create  doc       create  lib       create  lib/tasks       create  log       create  public/images       create  public/javascripts       create  public/stylesheets       create  script/performance       create  script/process       create  test/fixtures       create  test/functional       create  test/integration       create  test/unit       create  vendor       create  vendor/plugins       create  tmp/sessions       create  tmp/sockets       create  tmp/cache       create  tmp/pids       create  Rakefile       create  README       create  app/controllers/application.rb       create  app/helpers/application_helper.rb       create  test/test_helper.rb       create  config/database.yml       create  config/routes.rb       create  config/initializers/inflections.rb       create  config/initializers/mime_types.rb       create  config/initializers/new_rails_defaults.rb       create  config/boot.rb       create  config/environment.rb       create  config/environments/production.rb       create  config/environments/development.rb       create  config/environments/test.rb       create  script/about       create  script/console       create  script/dbconsole       create  script/destroy       create  script/generate       create  script/performance/benchmarker       create  script/performance/profiler       create  script/performance/request       create  script/process/reaper       create  script/process/spawner       create  script/process/inspector       create  script/runner       create  script/server       create  script/plugin       create  public/dispatch.rb       create  public/dispatch.cgi       create  public/dispatch.fcgi       create  public/404.html       create  public/422.html       create  public/500.html       create  public/index.html       create  public/favicon.ico       create  public/robots.txt       create  public/images/rails.png       create  public/javascripts/prototype.js       create  public/javascripts/effects.js       create  public/javascripts/dragdrop.js       create  public/javascripts/controls.js       create  public/javascripts/application.js       create  doc/README_FOR_APP       create  log/server.log       create  log/production.log       create  log/development.log       create  log/test.log

3. Start GlassFish as:
   

   ~/testbed/glassfish/v3/tp2/glassfishv3-tp2/glassfish >java -DJRUBY_HOME=/Users/arungupta/testbed/rails21/jruby-1.1.2 -jar modules/glassfish-10.0-tp-2-SNAPSHOT.jar Jun 17, 2008 6:14:21 PM com.sun.enterprise.glassfish.bootstrap.ASMain main INFO: Launching GlassFish on HK2 platform Jun 17, 2008 6:14:22 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 8080 Jun 17, 2008 6:14:22 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 8181 Jun 17, 2008 6:14:22 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 4848 Jun 17, 2008 6:14:22 PM com.sun.enterprise.v3.admin.adapter.AdminConsoleAdapter setContextRoot INFO: Admin Console Adapter: context root: /admin Jun 17, 2008 6:14:22 PM com.sun.enterprise.v3.server.AppServerStartup run INFO: Glassfish v3 started in 974 ms

4. Deploy the newly created application as:
   

   ~/testbed/rails21/jruby-1.1.2/samples/rails >~/testbed/glassfish/v3/tp2/glassfishv3-tp2/glassfish/bin/asadmin deploy runner Command deploy executed successfully.

   and the GlassFish console shows:

   Jun 17, 2008 6:14:41 PM com.sun.enterprise.rails.RailsDeployer registerAdapter INFO: Loading application runner at /runner Jun 17, 2008 6:14:41 PM   INFO: Starting Rails instances Jun 17, 2008 6:14:49 PM   SEVERE: JRuby limited openssl loaded. gem install jruby-openssl for full support. http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL Jun 17, 2008 6:14:51 PM com.sun.grizzly.jruby.RubyObjectPool$1 run INFO: Rails instance instantiation took : 9066ms Jun 17, 2008 6:14:51 PM com.sun.enterprise.v3.deployment.DeployCommand execute INFO: Deployment of runner done is 9168 ms

   The default page at “http://localhost:8080/runner” shows

   

5. Generate a Scaffold as described in TOTD #28
   

   ~/testbed/rails21/jruby-1.1.2/samples/rails/runner >../../../bin/jruby -S rake db:create (in /Users/arungupta/testbed/rails21/jruby-1.1.2/samples/rails/runner) ~/testbed/rails21/jruby-1.1.2/samples/rails/runner >../../../bin/jruby script/generate scaffold distance miles:float run_at:datetime JRuby limited openssl loaded. gem install jruby-openssl for full support. http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL       exists  app/models/       exists  app/controllers/       exists  app/helpers/       create  app/views/distances       exists  app/views/layouts/       exists  test/functional/       exists  test/unit/       exists  public/stylesheets/       create  app/views/distances/index.html.erb       create  app/views/distances/show.html.erb       create  app/views/distances/new.html.erb       create  app/views/distances/edit.html.erb       create  app/views/layouts/distances.html.erb       create  public/stylesheets/scaffold.css       create  app/controllers/distances_controller.rb       create  test/functional/distances_controller_test.rb       create  app/helpers/distances_helper.rb        route  map.resources :distances   dependency  model       exists    app/models/       exists    test/unit/       exists    test/fixtures/       create    app/models/distance.rb       create    test/unit/distance_test.rb       create    test/fixtures/distances.yml       create    db/migrate       create    db/migrate/20080618012326_create_distances.rb ~/testbed/rails21/jruby-1.1.2/samples/rails/runner >../../../bin/jruby -S rake db:migrate (in /Users/arungupta/testbed/rails21/jruby-1.1.2/samples/rails/runner) == 20080618012326 CreateDistances: migrating ================================== — create_table(:distances)    -> 0.0080s == 20080618012326 CreateDistances: migrated (0.0090s) =========================

6. Edit line 44 of “config/environment.rb” to change the default timezone from “UTC” to “Pacific Time (US & Canada)”. The updated line looks like:
   

   config.time_zone = ‘Pacific Time (US & Canada)’

7. Creating a new scaffold entry shows the following screen:

   

   Notice how default timezone is selected using Rails 2.1 Time Zone Support. After creating couple of entries (as described in TOTD #28), the page at “http://localhost:8080/runner/distances” looks like:

   

   Notice how “-0700″ is shown which is the offset for US Pacific Time during daylight savings.

The same application can also be easily deployed on GlassFish v3 Gem. Let’s see how:

1. Install GlassFish v3 Gem as:

   ~/testbed/rails21/jruby-1.1.2 >bin/jruby -S gem install glassfish JRuby limited openssl loaded. gem install jruby-openssl for full support. e="font-family: monospace;">http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL Updating metadata for 13 gems from http://gems.rubyforge.org/ …………. complete Successfully installed glassfish-0.2.0-universal-java 1 gem installed

2. Deploy the previously created Rails application as:
   

   ~/testbed/rails21/jruby-1.1.2/samples/rails >../../bin/jruby -S glassfish_rails runner Jun 17, 2008 6:39:37 PM com.sun.enterprise.glassfish.bootstrap.ASMain main INFO: Launching GlassFish on HK2 platform Jun 17, 2008 6:39:37 PM com.sun.enterprise.glassfish.bootstrap.ASMainHK2 findDerbyClient INFO: Cannot find javadb client jar file, jdbc driver not available Jun 17, 2008 6:39:38 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3000 Jun 17, 2008 6:39:38 PM com.sun.enterprise.v3.services.impl.GrizzlyEmbeddedHttpConfigurator configureSSL WARNING: pewebcontainer.all_ssl_protocols_disabled Jun 17, 2008 6:39:38 PM com.sun.enterprise.v3.services.impl.GrizzlyEmbeddedHttpConfigurator configureSSL WARNING: pewebcontainer.all_ssl_ciphers_disabled Jun 17, 2008 6:39:38 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3131 Jun 17, 2008 6:39:38 PM com.sun.enterprise.v3.services.impl.GrizzlyProxy start INFO: Listening on port 3838 Jun 17, 2008 6:39:39 PM com.sun.enterprise.v3.admin.adapter.AdminConsoleAdapter setContextRoot INFO: Admin Console Adapter: context root: /admin Jun 17, 2008 6:39:39 PM com.sun.enterprise.rails.RailsDeployer registerAdapter INFO: Loading application runner at / Jun 17, 2008 6:39:39 PM  INFO: Starting Rails instances Jun 17, 2008 6:39:44 PM  SEVERE: JRuby limited openssl loaded. gem install jruby-openssl for full support. http://wiki.jruby.org/wiki/JRuby_Builtin_OpenSSL Jun 17, 2008 6:39:45 PM com.sun.grizzly.jruby.RubyObjectPool$1 run INFO: Rails instance instantiation took : 6710ms Jun 17, 2008 6:39:45 PM com.sun.enterprise.v3.server.AppServerStartup run INFO: Glassfish v3 started in 8053 ms

   The page at “http://localhost:3000/runner” looks like:

   

Let us know on GlassFish Webtier Forum or Webtier Alias if you tried any of your Rails application on GlassFish. Please file bugs at GlassFish Issue Tracker (“V3″ as “Found in Version:” and “jruby” as “Subcomponent:”) if your app is not working.

Technorati: glassfish v3 rubyonrails jruby ruby gem