glassfish 1.0.2-universal-java → 1.0.3.beta.1-universal-java

data/History.txt

@@ -1,3 +1,19 @@
+== 1.0.3
+
+Under new management.
+
+Verified to be compatible with Rails 3.
+
+Can be daemonized with JRuby 1.5+ (JRUBY-4752).
+
+Daemon mode in Mac OS X.
+
+Log level can be either an integer or the corresponding string.
+
+== 1.0.2
+
+Fix for regression caused in 1.0.1 in daemon mode.
+
 == 1.0.1
 
 This is a quick update to 1.0.0.

data/README.md

@@ -0,0 +1,157 @@
+# Glassfish gem
+
+## Introduction
+
+GlassFish gem is a lightweight and robust deployment solution for
+Ruby on Rails applications deployed on JRuby runtime. It is based
+on GlassFish v3 application server.
+
+GlassFish v3 is a Java based application server that allows deployment, 
+administration and monitoring of JavaEE as well as dynamic languages based web 
+frameworks such as Ruby On Rails, Grails etc.
+
+GlassFish gem is based on GlassFish v3 nucleus. GlassFish v3 nucleus is the core module of GlassFish v3.
+
+For more information on GlassFish v3 application server see [GlassFish project page](https://glassfish.dev.java.net/).
+
+## Requirement
+[JDK 6](http://java.sun.com/javase/downloads/index.jsp) is required.
+
+## Supported Rack-based frameworks
+
+* Rails
+* Merb
+* Sinatra
+
+## Getting Started
+
+1. Install the gem:
+
+    gem install glassfish
+
+2. Run glassfish in the top directory of your Rails or Merb application:
+
+    a. `jruby -S glassfish`
+
+    b. For applications that use Bundler:
+
+        jruby -S bundle exec glassfish
+
+## Usage
+
+GlassFish gem's `glassfish` command autodetects the application you trying to
+run on it. Internally it uses Grizzly handler to plug into Rack interface of
+the application frameworks such as Rails, Merb or Sinatra.
+
+    $ glassfish
+
+That's all you need to run your application.
+
+    $ glassfish -h
+
+To run your rackup script
+
+    $ rackup -s Glassfish
+
+or
+    $ glassfish
+
+
+## Synopsis
+	
+	glassfish: GlassFish v3 server for Rack based frameworks such as: Rails,
+	Merb, Sinatra...
+
+    Usage:
+    glassfish [OPTION] APPLICATION_PATH
+
+    -h, --help:             show help
+
+    -c, --contextroot PATH: change the context root (default: '/')
+
+    -p, --port PORT:        change server port (default: 3000)
+
+    -a, --address HOST:     bind to HOST address (default: 0.0.0.0)
+
+    -e, --environment ENV:  change rails environment (default: development)
+
+    -n --runtimes NUMBER:   Number of JRuby runtimes to create initially
+
+    --runtimes-min NUMBER:  Minimum JRuby runtimes to create
+
+    --runtimes-max NUMBER:  Maximum number of JRuby runtimes to create
+
+    -d, --daemon:           Run GlassFish as daemon. Currently works with
+                            Linux and Solaris OS.
+
+    -P, --pid FILE:         PID file where PID will be written. Applicable
+                            when used with -d option. The default pid file
+                            is tmp/pids/glassfish-<PID>.pid
+
+    -l, --log FILE:         Log file, where the server log messages will go.
+                            By default the server logs go to
+                            log/development.log file. To see the logs on
+                            console run with -l option without any argument.
+
+    --log-level LEVEL:      Log level 0 to 7, or equivalent name as string.
+                            Default is 3 (or INFO).
+                            0 (OFF), 1 (SEVERE), 2 (WARNING), 3 (INFO),
+                            4 (FINE), 5 (FINER), 6 (FINEST), 7 (ALL).
+
+    --config FILE:          Configuration file location. Use glassfish.yml
+                            as template. Generate it using 'gfrake config'
+                            command.
+
+    APPLICATION_PATH (optional): Path to the application to be run (default:
+    current).
+
+    For further configuration, run GlassFish rake command 'gfrake -T'
+
+## Configuration
+
+	$ jruby -S gfrake -T
+	
+	rake clean    # Clean GlassFish generated temporary files (tmp/.glassfish)
+	rake config   # Generate a configuration file to customize GlassFish gem
+	rake version  # Display version of GlassFish gem
+	
+* Note: Although help screen shows `rake` command, you need to use `gfrake` instead.
+
+* `gfrake config` will place `glassfish.yml` in the application's config directory.
+`glassfish.yml` contains default options. Use it as template.
+You can also use `--config` option with the `glassfish` command
+
+## Application auto-detection
+
+Rails, Merb and Sinatra applications are detected automatically and configured appropriately.
+You can provide a rack-up script `*.ru` in to the application directory to plug in any other framework.
+
+Some key points:
+
+* Rails version < 2.2 is single threaded, for improved scaling you can  
+  configure the JRuby runtime pool using `--runtimes`, `--runtimes-min` or
+  `--runtimes-max` options.
+* Multi-thread-safe execution (as introduced in Rails 2.2 or for Merb) is 
+  detected and runtime pooling is disabled. You would still need to tell Rails 
+  to enable multi-threading by commenting out the following line from 
+  `config/environments/production.rb`.
+  
+  `#config.threadsafe!`
+  
+  Or you can simply call `config.threadsafe!` form any Rails initialization
+  script.
+
+## Known Issues
+
+* Running `glassfish` in a directory that is neither a Rails or Merb
+  application does not report a meaningful error.
+  See [this issue](https://glassfish.dev.java.net/issues/show_bug.cgi?id=6744).
+
+
+## Source
+
+This fork is available on [Github](http://github.com/BanzaiMan/glassfish-gem).
+
+## License
+
+GlassFish v3 gem is provided with [CDDL 1.0 and GPL 2.0 dual license](https://glassfish.dev.java.net/public/CDDL+GPL.html).

data/bin/gfrake

@@ -1,3 +1,5 @@
+#! /usr/bin/env jruby
+
 #--
 #DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
 #

data/bin/glassfish

@@ -1,56 +1,60 @@
- # == Synopsis
- #
- # glassfish: GlassFish v3 server for Rack based frameworks such as: Rails, Merb, Sinatra...
- #
- # == Usage:
- #
- # glassfish [OPTION] APPLICATION_PATH
- #
- # -h, --help::
- #    show help
- #
- # -c, --contextroot PATH::
- #    change the context root (default: '/')
- #
- # -p, --port PORT::
- #    change server port (default: 3000)
- #
- # -a, --address HOST::
- #    bind to HOST address (default: 0.0.0.0)
- #
- # -e, --environment ENV::
- #    change rails environment (default: development)
- #
- # -n --runtimes NUMBER::
- #    Number of JRuby runtimes to create initially
- #
- # --runtimes-min NUMBER::
- #    Minimum JRuby runtimes to create
- #
- # --runtimes-max NUMBER::
- #    Maximum number of JRuby runtimes to create
- #
- # -d, --daemon::
- #   Run GlassFish as daemon. Currently works with Linux and Solaris OS.
- #
- # -P, --pid FILE::
- #   PID file where PID will be written. Applicable when used with -d option. The default pid file is tmp/pids/glassfish-<PID>.pid
- #
- # -l, --log FILE::
- #   Log file, where the server log messages will go. By default the server logs go to log/development.log file. To see the logs on console run with -l option without any argument.
- #
- # --log-level LEVEL::
- #   Log level 0 to 7. 0:OFF, 1:SEVERE, 2:WARNING, 3:INFO (default), 4:FINE, 5:FINER, 6:FINEST, 7:ALL.
- #
- # --config FILE::
- #   Configuration file location. Use glassfish.yml as template. Generate it using 'gfrake config' command.
- #
- # APPLICATION_PATH (optional):  Path to the application to be run (default: current).
- #
- # For further configuration, run GlassFish rake command 'gfrake -T'
+#! /usr/bin/env jruby
 
- require 'glassfish'
+# == Synopsis
+#
+# glassfish: GlassFish v3 server for Rack based frameworks such as: Rails, Merb, Sinatra...
+#
+# == Usage:
+#
+# glassfish [OPTION] APPLICATION_PATH
+#
+# -h, --help::
+#    show help
+#
+# -c, --contextroot PATH::
+#    change the context root (default: '/')
+#
+# -p, --port PORT::
+#    change server port (default: 3000)
+#
+# -a, --address HOST::
+#    bind to HOST address (default: 0.0.0.0)
+#
+# -e, --environment ENV::
+#    change rails environment (default: development)
+#
+# -n --runtimes NUMBER::
+#    Number of JRuby runtimes to create initially
+#
+# --runtimes-min NUMBER::
+#    Minimum JRuby runtimes to create
+#
+# --runtimes-max NUMBER::
+#    Maximum number of JRuby runtimes to create
+#
+# -d, --daemon::
+#   Run GlassFish as daemon. Currently works with Linux and Solaris OS.
+#
+# -P, --pid FILE::
+#   PID file where PID will be written. Applicable when used with -d option. The default pid file is tmp/pids/glassfish-<PID>.pid
+#
+# -l, --log FILE::
+#   Log file, where the server log messages will go. By default the server logs go to log/development.log file. To see the logs on console run with -l option without any argument.
+#
+# --log-level LEVEL::
+#   Log level 0 to 7, or equivalent name as string. Default is 3 (or INFO). 0 (OFF), 1 (SEVERE), 2 (WARNING), 3 (INFO), 4 (FINE), 5 (FINER), 6 (FINEST), 7 (ALL).
+#
+# --config FILE::
+#   Configuration file location. Use glassfish.yml as template. Generate it using 'gfrake config' command.
+#
+# APPLICATION_PATH (optional):  Path to the application to be run (default: current).
+#
+# For further configuration, run GlassFish rake command 'gfrake -T'
 
- options = GlassFish::CommandLineParser.new.parse
- GlassFish::Server.start options
+require 'glassfish'
 
+options = GlassFish::CommandLineParser.new.parse
+
+ENV['RAILS_ENV'] = options[:environment]
+
+GlassFish::Server.start options

data/generators/gfrake/templates/glassfish.yml

@@ -71,7 +71,7 @@ log:
 
     # Logging level. Log level 0 to 7. 0:OFF, 1:SEVERE, 2:WARNING,
     # 3:INFO (default), 4:FINE, 5:FINER, 6:FINEST, 7:ALL.
-    log-level: 3
+    log-level: info
 
 #
 # Runtime configuration
@@ -129,8 +129,4 @@ daemon:
     # JVM ergonomics document, 
     # http://java.sun.com/javase/6/docs/technotes/guides/vm/gc-ergonomics.html
     #
-    #jvm-options: -server -Xmx2500m -Xms64m -XX:PermSize=256m -XX:MaxPermSize=256m -XX:NewRatio=2 -XX:+DisableExplicitGC -Dhk2.file.directory.changeIntervalTimer=6000
-
-
-
-    
+    #jvm-options: -server -Xmx2500m -Xms64m -XX:PermSize=256m -XX:MaxPermSize=256m -XX:NewRatio=2 -XX:+DisableExplicitGC -Dhk2.file.directory.changeIntervalTimer=6000

data/lib/asadmin.rb

@@ -34,7 +34,8 @@
 #holder.
 #++
 
-require 'admin-cli.jar'
+require File.join(File.dirname(__FILE__), 'java', 'glassfish-embedded-nucleus')
+require File.join(File.dirname(__FILE__), 'java', 'admin-cli.jar')
 require 'java'
 
 #
@@ -43,7 +44,7 @@ require 'java'
 #
 module GlassFish
   class ASAdmin
-    import com.sun.enterprise.admin.cli.AsadminMain
+    java_import com.sun.enterprise.admin.cli.AsadminMain
     AsadminMain.main(ARGV.to_java :String)
   end
 end

data/lib/command_line_parser.rb

@@ -34,11 +34,14 @@
 #holder.
 #++
 
+$LOAD_PATH << "#{File.dirname(__FILE__)}/../lib/java"
+
 require 'rdoc_usage'
 require 'getoptlong'
 require 'pathname'
 require 'config'
 require 'java'
+require 'glassfish-gem.jar'
 
 #
 # Parses command line options
@@ -106,7 +109,11 @@ module GlassFish
             config[:log] = File.expand_path arg
           end
         when '--log-level'
-          config[:log_level] = arg.to_i
+          if arg =~ /^[0-7]$/
+            config[:log_level] = arg.to_i
+          else
+            config[:log_level] = org.glassfish.scripting.gem.Options::LogLevel.value_of(arg.to_s.upcase).ordinal
+          end
         when '--config'
           config_file = arg
         end
@@ -159,7 +166,12 @@ module GlassFish
           end
 
           val = arg['log-level']
-          config[:log_level] = val.to_i unless val.nil?
+          puts "arg['log-level']: #{arg['log-level']}"
+          if val.to_s =~ /^[0-7]$/
+            config[:log_level] = val.to_i
+          else
+            config[:log_level] = org.glassfish.scripting.gem.Options::LogLevel.value_of(val.to_s.upcase).ordinal
+          end
         when 'jruby-runtime-pool'
           config[:runtimes] = arg['initial'] unless arg['initial'].nil?
           config[:runtimes_min] = arg['min'] unless arg['min'].nil?

data/lib/config.rb

@@ -36,7 +36,8 @@
 
 require 'java'
 require 'yaml'
-require 'ftools'
+require 'fileutils'
+require 'rake'
 require 'socket'
 
 module GlassFish
@@ -83,11 +84,8 @@ module GlassFish
       if(config[:daemon])
         os = java.lang.System.getProperty("os.name").downcase
         version = java.lang.System.getProperty("os.version")
-        #check the platform, Currently daemon mode works only on linux and
-        #solaris
-        if(!os.include?("linux") and !os.include?("sunos"))
-          Config.fail "You are running on #{java.lang.System.getProperty("os.name")}  #{version}. Currently daemon mode only works on Linux or Solaris platforms!"
-        end
+
+        validate_os_for_daemon_support(os)
 
         # In daemon mode you can't log to console. Let's fail and let user spcifiy the log file explicitly
 	      if(config[:log_console])
@@ -105,6 +103,10 @@ module GlassFish
         Config.absolutize config[:app_dir], config[:pid]
       end
 
+      unless dir_has_app? config[:app_dir]
+        raise RuntimeError, "#{config[:app_dir]} does not contain supported application"
+      end
+
       # log_level
       if not (0..7).include?(config[:log_level])
         STDERR.puts "Invalid log level #{config[:log_level]}. Chose a number between 0 to 7."
@@ -116,25 +118,7 @@ module GlassFish
         config[:runtimes_max] = config[:runtimes]
       end
 
-      # JRuby runtime
-      runtimes_err = " Invalid runtime configuration, initial:#{config[:runtimes]}, min:#{config[:runtimes_min]}, max:#{config[:runtimes_max]}."
-      err = false
-      if(config[:runtimes] < 1 || config[:runtimes] > config[:runtimes_max] || config[:runtimes] < config[:runtimes_min])
-        err = true;
-        runtimes_err +=  "\n\tinitial runtime must be > 0, <= runtimes-max and >= runtimes-min."
-      end
-      if(config[:runtimes_min] < 1 || config[:runtimes_min] > config[:runtimes] || config[:runtimes_min] > config[:runtimes_max])
-        err = true;
-        runtimes_err += "\n\truntimes-min must be > 0, <=runtimes-max and <= initial_runtmes"
-      end
-      if(config[:runtimes_max] < 1 || config[:runtimes_max] < config[:runtimes_min] || config[:runtimes_max] < config[:runtimes])
-        err=true
-        runtimes_err += "\n\truntimes-max must be > 0, >=runtimes-min and >= initial_runtmes"
-      end
-      if(err)
-        Config.fail runtimes_err
-      end
-
+      validate_runtimes_params(config)
 
       # contextroot
       # There is not much to validate here. For now we leave it as it is
@@ -198,13 +182,13 @@ module GlassFish
     def check_domain_dir?(domain_dir)
       #create Glassfish domain directory if it does not exist
       unless File.exist? domain_dir
-        File.makedirs(domain_dir)
+        FileUtils.mkdir_p(domain_dir)
         return true
       end
 
       config_dir = File.join(domain_dir, "config")
       unless File.exist? config_dir
-        File.makedirs(config_dir)
+        FileUtils.mkdir_p(config_dir)
         return true
       end
 
@@ -220,5 +204,80 @@ module GlassFish
       end
       true
     end
+
+    def validate_os_for_daemon_support(os)
+      #check the platform, Currently daemon mode works only on linux, solaris and Mac OS X.
+      if(!os.include?("linux") and !os.include?("sunos") and !os.include?("mac os x"))
+        Config.fail "You are running on #{java.lang.System.getProperty("os.name")}  #{version}. Currently daemon mode only works on Linux, Solaris or Mac OS X platform."
+      end
+
+    end
+
+    def validate_runtimes_params(config)
+      # JRuby runtime
+      runtimes_err = " Invalid runtime configuration, initial:#{config[:runtimes]}, min:#{config[:runtimes_min]}, max:#{config[:runtimes_max]}."
+      err = false
+      if(config[:runtimes] < 1 || config[:runtimes] > config[:runtimes_max] || config[:runtimes] < config[:runtimes_min])
+        err = true;
+        runtimes_err +=  "\n\tinitial runtime must be > 0, <= runtimes-max and >= runtimes-min."
+      end
+      if(config[:runtimes_min] < 1 || config[:runtimes_min] > config[:runtimes] || config[:runtimes_min] > config[:runtimes_max])
+        err = true;
+        runtimes_err += "\n\truntimes-min must be > 0, <=runtimes-max and <= initial_runtmes"
+      end
+      if(config[:runtimes_max] < 1 || config[:runtimes_max] < config[:runtimes_min] || config[:runtimes_max] < config[:runtimes])
+        err=true
+        runtimes_err += "\n\truntimes-max must be > 0, >=runtimes-min and >= initial_runtmes"
+      end
+      if(err)
+        Config.fail runtimes_err
+      end
+
+    end
+
+    def dir_has_app?(dir)
+      if ! File.directory?(dir)
+        return false
+      end
+
+      return dir_has_rails?(dir) || dir_has_merb?(dir) || dir_has_rack?(dir)
+    end
+
+    def dir_has_rails?(dir)
+      Dir.chdir(dir) do
+        app = Rake.application = RakeApp.new
+        app.load_rake_file
+        return false unless task = app.lookup("environment")
+      end
+      true
+    end
+
+    def dir_has_merb?(dir)
+      Dir.chdir(dir) do
+        app = Rake.application = RakeApp.new
+        app.load_rake_file
+        return false unless task = app.lookup("merb_env")
+      end
+      true
+    end
+
+    def dir_has_rack?(dir)
+      Dir.chdir(dir) do
+        return false unless File.exist?('config.ru') || ! Dir['*/config.ru'].empty?
+      end
+      true
+    end
+
+    class RakeApp < Rake::Application
+      def load_rake_file
+        Rake::Application::DEFAULT_RAKEFILES.each do |rf|
+          if File.exist? rf
+            load rf
+            break
+          end
+        end
+      end
+    end
+    
   end
 end

data/lib/jruby/rails_path.rb

@@ -1,8 +1,12 @@
 module Rails
-  class Configuration    
+  class Configuration
     def threadsafe?
       if(Rails::Configuration.instance_methods.include?'threadsafe!')
-        preload_frameworks && cache_classes && !dependency_loading && action_controller.allow_concurrency
+        if(Rails::Configuration.instance_methods.include?'preload_frameworks')
+          preload_frameworks && cache_classes && !dependency_loading && action_controller.allow_concurrency
+        else
+          cache_classes && !dependency_loading && action_controller.allow_concurrency
+        end
       else
         false
       end

data/lib/lib/asadmin/default.rb

@@ -0,0 +1 @@
+# empty file to suppress warning when we 'require "asadmin"'.

data/lib/server.rb

@@ -45,14 +45,15 @@ require 'java'
 require 'glassfish-gem.jar'
 require 'akuma.jar'
 require 'yaml'
-require 'ftools'
+require 'fileutils'
 require 'version'
 require 'config'
 
 module GlassFish
   class Server
-    import "org.glassfish.scripting.gem.GlassFishMain"
-    import "org.glassfish.scripting.gem.Options"
+    java_import "org.glassfish.scripting.gem.GlassFishMain"
+    java_import "org.glassfish.scripting.gem.Options"
+    java_import "com.sun.akuma.CLibrary"
 
     java.lang.System.setProperty("addtional.load.path", "#{File.dirname(__FILE__)}/../lib")
 
@@ -61,14 +62,14 @@ module GlassFish
     def initialize(args, &block)
 
       unless args[:log_level].nil?
-        if args[:log_level] > 4
+        if args[:log_level] > Options::LogLevel::FINE.ordinal
           puts "Arguments: "
           args.each do |k, v|
             puts "\t#{k}=>#{v}"
           end
         end
 
-        if args[:log_level] > 3
+        if args[:log_level] > Options::LogLevel::INFO.ordinal
           debug = true
         end
 
@@ -90,10 +91,9 @@ module GlassFish
       @opts.log = args[:log]
       @opts.log_console = args[:log_console]
       @opts.domainDir = args[:domain_dir]
-      @opts.log_level = args[:log_level]
+      @opts.log_level = Options::LogLevel.values()[args[:log_level]]
       @opts.jvm_opts = args[:jvm_options]
-
-
+      
       unless args[:grizzly_config].nil?
         args[:grizzly_config].each do |key, val|
           case key
@@ -127,7 +127,7 @@ module GlassFish
       end
 
       #Create the app using Rack builder
-      if(block)
+      if block_given?
         app = Rack::Builder.new(&block).to_app
         app = Rack::CommonLogger.new(@app) if debug
         if app.nil?
@@ -147,6 +147,9 @@ module GlassFish
     end
 
     def start
+      ENV.each do |k,v|
+        CLibrary::LIBC.setenv(k, v)
+      end
       GlassFishMain.start @opts
     end
     alias :start! :start

data/lib/version.rb

@@ -35,6 +35,6 @@
 #++
 
 module GlassFish
-  VERSION = "1.0.2"
+  VERSION = "1.0.3.dev"
   FULLVERSION = "GlassFish gem version: #{VERSION}\nhttp://glassfishgem.rubyforge.org"
 end

metadata

@@ -1,15 +1,16 @@
 --- !ruby/object:Gem::Specification 
 name: glassfish
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
+  version: 1.0.3.beta.1
 platform: universal-java
 authors: 
+  - Hirotsugu Asari
   - Vivek Pandey
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2009-12-22 00:00:00 -08:00
+date: 2010-12-07 00:00:00 -05:00
 default_executable: glassfish
 dependencies: 
   - !ruby/object:Gem::Dependency 
@@ -25,16 +26,16 @@ dependencies:
 description: |-
   GlassFish gem is an embedded GlassFish V3 application server which
                                   would help run your Ruby on Rails application
-email: vivek.pandey@sun.com
+email: 
+  - asari.ruby@gmail.com
+  - vivek.pandey@sun.com
 executables: 
   - glassfish
   - gfrake
 extensions: []
 
-extra_rdoc_files: 
-  - README.txt
-  - History.txt
-  - LICENSE.txt
+extra_rdoc_files: []
+
 files: 
   - bin/gfrake
   - bin/glassfish
@@ -52,18 +53,20 @@ files:
   - lib/java/glassfish-gem.jar
   - lib/java/grizzly-jruby-module.jar
   - lib/java/grizzly-jruby.jar
+  - lib/java/jna.jar
   - lib/jruby/rails_path.rb
   - lib/jruby/rack/grizzly_helper.rb
   - lib/jruby/rack/merb.rb
   - lib/jruby/rack/rackup.rb
   - lib/jruby/rack/rails.rb
   - lib/jruby/rack/sinatra.rb
+  - lib/lib/asadmin/default.rb
   - lib/rack/adapter/merb.rb
   - lib/rack/adapter/rails.rb
   - lib/rack/handler/glassfish.rb
   - lib/rack/handler/grizzly.rb
   - generators/gfrake/templates/glassfish.yml
-  - README.txt
+  - README.md
   - History.txt
   - LICENSE.txt
 has_rdoc: true
@@ -83,9 +86,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
   version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
-    - - ">="
+    - - ">"
       - !ruby/object:Gem::Version 
-        version: "0"
+        version: 1.3.1
   version: 
 requirements: []
 

data/README.txt

@@ -1,148 +0,0 @@
-= GlassFish v3 server for Rack based web frameworks (Rails, Merb, ...)
-
-GlassFish gem is a lightweight and robust deployment solution for
-Ruby on Rails applications deployed on JRuby runtime. It is based
-on GlassFish v3 application server.
-
-GlassFish v3 is a Java based application server that allows deployment, 
-administration and monitoring of JavaEE as well as dynamic languages based web 
-frameworks such as Ruby On Rails, Grails etc.
-
-GlassFish gem is based on GlassFish v3 nucleus. GlassFish v3 nucleus is the core module of GlassFish v3.
-
-For more information on GlassFish v3 application server see GlassFish project page[https://glassfish.dev.java.net/].
-
-== Requires JDK 6
-Get JDK 6 from here[http://java.sun.com/javase/downloads/index.jsp]
-
-== Supported Rack based frameworks
-
-* Rails
-* Merb
-* Sinatra
-
-=== Getting Started
-
-1. Install the gem: <tt>gem install glassfish</tt>.
-2. Run glassfish in the top directory of your Rails or Merb application: 
-	
-	$glassfish
-
-=== Usage
-
-GlassFish gem's +glassfish+ command autodetects the application you trying to 
-run on it. Internally it uses Grizzly handler to plugin to Rack interface of 
-the application frameworks such as Rails, Merb or Sinatra.
-
-    $ glassfish
-
-That's all you need to run your application.
-
-    $glassfish -h
-
-To run your rackup script
-
-    $ rackup -s Glassfish
-
-or
-    $ glassfish
-
-
-===Synopsis
-	
-	glassfish: GlassFish v3 server for Rack based frameworks such as: Rails,
-	Merb, Sinatra...
-
-===Usage:
-	
-	glassfish [OPTION] APPLICATION_PATH
-
-	-h, --help:             show help
-
-	-c, --contextroot PATH: change the context root (default: '/')
-
-	-p, --port PORT:        change server port (default: 3000)
-	
-	-a, --address HOST:     bind to HOST address (default: 0.0.0.0)
-
-	-e, --environment ENV:  change rails environment (default: development)
-
-	-n --runtimes NUMBER:   Number of JRuby runtimes to create initially
-
-	--runtimes-min NUMBER:  Minimum JRuby runtimes to create
-
-	--runtimes-max NUMBER:  Maximum number of JRuby runtimes to create
-
-	-d, --daemon:           Run GlassFish as daemon. Currently works with
-	                        Linux and Solaris OS.
-
-	-P, --pid FILE:         PID file where PID will be written. Applicable
-	                        when used with -d option. The default pid file
-	                        is tmp/pids/glassfish-<PID>.pid
-
-	-l, --log FILE:         Log file, where the server log messages will go.
-	                        By default the server logs go to
-	                        log/development.log file. To see the logs on
-	                        console run with -l option without any argument.
-
-	--log-level LEVEL:      Log level 0 to 7. 0:OFF, 1:SEVERE, 2:WARNING,
-	                        3:INFO (default), 4:FINE, 5:FINER, 6:FINEST,
-	                        7:ALL.
-
-	--config FILE:          Configuration file location. Use glassfish.yml
-	                        as template. Generate it using 'gfrake config'
-	                        command.
-
-	APPLICATION_PATH (optional): Path to the application to be run (default:
-	current).
-
-	For further configuration, run GlassFish rake command 'gfrake -T'
-
-===Configuration
-
-	$gfrake -T
-	
-	rake clean    # Clean GlassFish generated temporary files (tmp/.glassfish)
-	rake config   # Generate a configuration file to customize GlassFish gem
-	rake version  # Display version of GlassFish gem
-	
-<b>Note:</b> Although help screen shows rake command. You need to use gfrake instead.
-
-* <tt>gfrake config</tt> will place <b>glassfish.yml</b> in the application's config directory. <b>glassfish.yml</b> contains default options. Use it as template. You can also use <tt>--config</tt> option with the <tt>glassfish</tt> command	
-
-=== Application auto-detection
-
-Rails, Merb and Sinatra applications are detected automatically and configured appropriately. You can provide a rack-up script <tt>*.ru</tt> in to the application directory to plugin any other framework.
-
-Some key points:
-
-* Rails version < 2.2 is single threaded, for improved scaling you can  
-  configure the JRuby runtime pool using <tt>--runtimes, --runtimes-min or 
-  --runtimes-max</tt> options.
-* Multi-thread-safe execution (as introduced in Rails 2.2 or for Merb) is 
-  detected and runtime pooling is disabled. You would still need to tell Rails 
-  to enable multi-threading by commenting out the following line from 
-  <tt>config/environments/production.rb</tt>.
-  
-  <tt>#config.threadsafe!</tt>
-  
-  Or you can simply call config.threadsafe! form any Rails initialization 
-  script.
-
-=== Known Issues
-
-* Running <tt>glassfish</tt> in a directory that is neither a Rails or Merb
-  application does not report a meaningful error.
-  See this issue[https://glassfish.dev.java.net/issues/show_bug.cgi?id=6744]
-
-
-=== Source
-
-You can get the GlassFish source using svn, in any of the following ways:
-
-<tt>svn co https://svn.dev.java.net/svn/glassfish-scripting/trunk/rails/gem</tt>
-
-=== License
-
-GlassFish v3 gem is provided with CDDL 1.0 and GPL 2.0 dual license. For 
-details see https://glassfish.dev.java.net/public/CDDL+GPL.html.